home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 418_02 / doc / rasmol.doc < prev    next >
Encoding:
Text File  |  1994-03-02  |  72.3 KB  |  2,637 lines

  1. %% RasMol V2.30 Manual
  2. %% (c) Roger Sayle, January 1994
  3. %% Glaxo Research and Development
  4. %% Greenford, Middlesex
  5. %%
  6.  
  7. %%
  8. %% UNIX man(1) Headers
  9. %%
  10. MR.PU
  11. MR.TH RASMOL 1 "January 1994"
  12. MR.SH NAME
  13. MRRasMol 2.3 \- Molecular Graphics Visualisation Tool
  14.  
  15. %%
  16. %% RTF Headers
  17. %%
  18. RR{\rtf1\ansi
  19. RR{\fonttbl
  20. RR\f0\fswiss Arial;
  21. RR\f1\fdecor Symbol;
  22. RR\f2\fmodern Courier New;
  23. RR}\deff0\fs20
  24.  
  25. RR#{\footnote rasmol}
  26. RR${\footnote RasMol V2.3}
  27. RR+{\footnote doc}
  28.  
  29. RR\par{\fs28\b RasMol V2.3}\par\par
  30. RR{\fs24\b Molecular Visualisation Program}\par\par
  31. RR{\b Roger Sayle}\par
  32. RR{\b Glaxo Research and Development}\line
  33. RR{\b Greenford, Middlesex, U.K.}\par\par
  34. %%
  35. %% HTML Headers
  36. %%
  37. HR<title>RasMol V2.3 Molecular Visualisation Program</title>
  38. HR<h1>RasMol V2.3</h1><p>
  39. HR<h2>Molecular Visualisation Program</h2><p>
  40. HR<h3>Roger Sayle</h3>
  41. HR<h3>Glaxo Research and Development</h3>
  42. HR<h3>Greenford, Middlesex, U.K.</h3><p><p>
  43.  
  44. %%
  45. %% HTML Table of Contents
  46. %%
  47. HR<h2>Table of Contents</h2>
  48. HR<ol>
  49. HR<li><a href="#chintro">Introduction</a>
  50. HR<li><a href="#chcomref">Command Reference</a>
  51. HR<li><a href="#chsetopt">Internal Parameters</a>
  52. HR<li><a href="#chexprs">Atom Expressions</a>
  53. HR<li><a href="#predefinedsets">Predefined Sets</a>
  54. HR<li><a href="#chcolours">Colour Schemes</a>
  55. HR</ol>
  56.  
  57. RR\par{\fs24\b Table of Contents}\par\par
  58. RR\tx250\li250\fi-250
  59. RR{\f1\'b7}\tab
  60. RR{\uldb Introduction}{\v chintro}\par
  61. RR{\f1\'b7}\tab
  62. RR{\uldb Command Reference}{\v chcomref}\par
  63. RR{\f1\'b7}\tab
  64. RR{\uldb Internal Parameters}{\v chsetopt}\par
  65. RR{\f1\'b7}\tab
  66. RR{\uldb Atom Expressions}{\v chexprs}\par
  67. RR{\f1\'b7}\tab
  68. RR{\uldb Predefined Sets}{\v predefinedsets}\par
  69. RR{\f1\'b7}\tab
  70. RR{\uldb Colour Schemes}{\v chcolours}\par
  71. RR\pard
  72. AB
  73.  
  74. %% 
  75. %% Copyright Notices
  76. %%
  77. TTCopyright (C) 1992,1993,1994 by Roger Sayle (rasmol@ggr.co.uk)
  78. RTCopyright \'a9 1992,1993,1994 by Roger Sayle (rasmol@ggr.co.uk)
  79. HT<p><p>Copyright (c) 1992,1993,1994 by Roger Sayle 
  80. HT<address>rasmol@ggr.co.uk</address>
  81. AP
  82.  
  83. RR{\fs16
  84. VTThe information supplied in this document is believed to be true but
  85. VTno liability is assumed for its use or for the infringements of the
  86. VTrights of the others resulting from its use.
  87. VP
  88.  
  89. VTInformation in this document is subject to change without notice and does
  90. VTnot represent a commitment on the part of the supplier. This package is
  91. VTsold/distributed subject to the condition that it shall not, by way of
  92. VTtrade or otherwise, be lent, re-sold, hired out or otherwise circulated
  93. VTwithout the supplier's prior consent, in any form of packaging or cover
  94. VTother than that in which it was produced. No part of this manual or
  95. VTaccompanying software may be reproduced, stored in a retrieval system on
  96. VToptical or magnetic disk, tape or any other medium, or transmitted in any
  97. VTform or by any means, electronic, mechanical, photocopying, recording or
  98. VTotherwise for any purpose other than the purchaser's personal use.
  99. VP
  100.  
  101. VTThis product is not to be used in the planning, construction, maintenance,
  102. VToperation or use of any nuclear facility nor the flight, navigation or
  103. VTcommunication of aircraft or ground support equipment. The author shall
  104. VTnot be liable, in whole or in part, for any claims or damages arising
  105. VTfrom such use, including death, bancruptcy or outbreak of war.
  106. RR}
  107. AB
  108.  
  109. %%
  110. %% Man Page Synopsis
  111. %%
  112. MR.SH SYNOPSIS
  113. MR.B rasmol
  114. MR.RB [ options ] 
  115. MR[
  116. MR.I pdbfile
  117. MR]
  118.  
  119. %%
  120. %% Simple Description
  121. %%
  122. TR    INTRODUCTION
  123. TR    ============
  124. TR
  125. RR#{\footnote chintro}
  126. RR${\footnote Introduction}
  127. RR{\fs24\b Introduction}\par\par
  128. MR.SH DESCRIPTION
  129. HR<a name="chintro"><h2>Introduction</h2></a>
  130. ATRasMol2 is an X11 windows system tool intended for the visualisation of
  131. ATproteins and nucleic acids. RasMol requires either an 8bit pseudo colour
  132. ATor a 24bit (32bit) true colour display. The program reads in a specified
  133. ATBrookhaven protein databank (PDB) file and determines the connectivity from
  134. ATthe residue information provided. This may then rendered on the screen
  135. ATin a variety of formats and colour schemes. Currently available molecule
  136. ATrepresentations include depth-cued wireframes, sticks, space filling `union 
  137. ATof spheres', ball and stick models and protein ribbon diagrams.
  138. PP
  139.  
  140. PRThe RasMol help facility can be accessed by typing "help <topic>" or
  141. PR"help <topic> <subtopic>" from the command line. A complete list of RasMol
  142. PRcommands may be displayed by typing "help commands". A single question
  143. PRmark may also be used to abbreviate the keyword "help".
  144. PR
  145. PRCopyright (c) 1992-1994 by Roger Sayle (ras32425@ggr.co.uk)
  146. AB
  147.  
  148. %% 
  149. %% Commands Introduction
  150. %%
  151. RR#{\footnote chcomref}
  152. RR${\footnote Command Reference}
  153. RR{\fs24\b Command Reference}\par\par
  154. MR.SH COMMANDS
  155. PR?commands
  156. PR?keywords
  157. HR<a name="chcomref"><h2>Command Reference</h2></a>
  158. TR    COMMANDS
  159. TR    ========
  160. TR
  161.  
  162. ATRasMol allows the execution of interactive commands typed at the
  163. AC"RasMol>
  164. ATprompt in the terminal window. Each command must be given on
  165. ATa separate line. Keywords are case insensitive and may be entered in
  166. ATeither upper or lower case letters. All whitespace characters are
  167. ATignored except to separate keywords and their arguments.
  168. AP
  169.  
  170. ATThe commands/keywords currently recognised by RasMol are given below.
  171. PRType "help <command>" for more information on each RasMol function.
  172. AP
  173.  
  174. PR    backbone        colour          exit            hbond
  175. PR    help            load            quit            reset
  176. PR    restrict        ribbon          rotate          save            
  177. PR    script          select          set             show            
  178. PR    slab            spacefill       structure       ssbond          
  179. PR    translate       wireframe       write           zap             
  180. PR    zoom
  181. PP
  182.  
  183. HR<pre>
  184. HR    <a href="#backbone">Backbone</a 
  185. HR>    <a href="#background">Background</a
  186. HR>    <a href="#centre">Centre</a>
  187. HR    <a href="#colour">Colour</a
  188. HR>        <a href="#hbonds">HBonds</a
  189. HR>        <a href="#help">Help</a>
  190. HR    <a href="#load">Load</a
  191. HR>        <a href="#quit">Quit</a
  192. HR>        <a href="#renumber">Renumber</a>
  193. HR    <a href="#reset">Reset</a
  194. HR>        <a href="#restrict">Restrict</a
  195. HR>    <a href="#ribbons">Ribbons</a>
  196. HR    <a href="#rotate">Rotate</a
  197. HR>        <a href="#save">Save</a
  198. HR>        <a href="#script">Script</a>
  199. HR    <a href="#select">Select</a
  200. HR>        <a href="#set">Set</a
  201. HR>        <a href="#show">Show</a>
  202. HR    <a href="#slab">Slab</a
  203. HR>        <a href="#spacefill">Spacefill</a
  204. HR>    <a href="#structure">Structure</a>
  205. HR    <a href="#ssbonds">SSBonds</a
  206. HR>        <a href="#translate">Translate</a
  207. HR>    <a href="#wireframe">Wireframe</a>
  208. HR    <a href="#write">Write</a
  209. HR>        <a href="#zap">Zap</a
  210. HR>        <a href="#zoom">Zoom</a>
  211. HR</pre><hr>
  212.  
  213. RR\cellx1200\cellx2400\cellx3600\cellx4800
  214. RR\intbl
  215. RR{\uldb backbone}{\v backbone}\cell
  216. RR{\uldb colour}{\v colour}\cell
  217. RR{\uldb exit}{\v exit}\cell
  218. RR{\uldb hbond}{\v hbond}\cell
  219. RR\row\intbl
  220. RR{\uldb help}{\v help}\cell
  221. RR{\uldb load}{\v load}\cell
  222. RR{\uldb quit}{\v quit}\cell
  223. RR{\uldb reset}{\v reset}\cell
  224. RR\row\intbl
  225. RR{\uldb restrict}{\v restrict}\cell
  226. RR{\uldb ribbon}{\v ribbon}\cell
  227. RR{\uldb rotate}{\v rotate}\cell
  228. RR{\uldb save}{\v save}\cell
  229. RR\row\intbl
  230. RR{\uldb script}{\v script}\cell
  231. RR{\uldb select}{\v select}\cell
  232. RR{\uldb set}{\v set}\cell
  233. RR{\uldb show}{\v show}\cell
  234. RR\row\intbl
  235. RR{\uldb slab}{\v slab}\cell
  236. RR{\uldb spacefill}{\v spacefill}\cell
  237. RR{\uldb structure}{\v structure}\cell
  238. RR{\uldb ssbond}{\v ssbond}\cell
  239. RR\row\intbl
  240. RR{\uldb translate}{\v translate}\cell
  241. RR{\uldb wireframe}{\v wireframe}\cell
  242. RR{\uldb write}{\v write}\cell
  243. RR{\uldb zap}{\v zap}\cell
  244. RR{\uldb zoom}{\v zoom}\cell
  245. RR\row\pard\par
  246. RB
  247.  
  248. %%
  249. %% Commands Reference
  250. %%
  251. ASBackbone
  252. NRSyntax:  backbone {<boolean>}
  253. NR         backbone <value>
  254. NR
  255. HR<pre>
  256. HRSyntax:  backbone {<boolean>}
  257. HR         backbone <value>
  258. HR</pre><p>
  259. RR\tx1200
  260. RR{\f2\b Syntax:\tab
  261. RRbackbone \{<boolean>\}\line\tab
  262. RRbackbone <value>\par
  263. RR}\pard\par
  264.  
  265. ATThe RasMol
  266. ACbackbone
  267. ATcommand permits the representation of a polypeptide
  268. ATbackbone as a series of bonds connecting the adjacent alpha carbons of 
  269. ATeach amino acid in a chain. The display of these backbone `bonds' is
  270. ATturned on and off by the command paramater the same as the
  271. AXwireframe wireframe
  272. ATcommand. The command
  273. ACbackbone off
  274. ATturns off the selected `bonds', and
  275. ACbackbone on
  276. ATor with a number turns them on. The number can be used
  277. ATto determine the cylinder radius of the representation in 0.004 angstrom
  278. ATunits. Backbone objects may be coloured using the RasMol 
  279. AXcolour colour backbone
  280. ATcommand. A parameter value of 500 (2 angstroms) or above results in an 
  281. AT"Integer argument too large" error. 
  282. PP
  283. PTThe reserved work backbone is also used as a predefined set ("help sets")
  284. PTand as a parameter to the `set hbond' and `set ssbond' commands.
  285. AB
  286.  
  287.  
  288. ASBackground
  289. NRSyntax:  background <colour>
  290. NR
  291. HR<pre>
  292. HRSyntax:  background <colour>
  293. HR</pre><p>
  294. RR\tx1200
  295. RR{\f2\b Syntax:\tab
  296. RRbackground <colour>\par
  297. RR}\pard\par
  298.  
  299. ATThe RasMol
  300. ACbackground
  301. ATcommand is used to set the colour of the "canvas" background. The
  302. ATcolour may be given as either a colour name or a comma separated
  303. ATtriple of Red, Green and Blue (RGB) components enclosed in square
  304. ATbrackets. Typing the command 
  305. AXhelp help colours
  306. ATwill give a list of the predefined colour names recognised by RasMol. 
  307. ATWhen running under X Windows, RasMol also recognises colours in the 
  308. ATX server's colour name database.
  309. AB
  310.  
  311.  
  312. PR?center
  313. RR#{\footnote center}
  314. ASCentre
  315. NRSyntax:  center {<expression>}
  316. NR         centre {<expression>}
  317. NR
  318. HR<pre>
  319. HRSyntax:  center {<expression>}
  320. HR         centre {<expression>}
  321. HR</pre><p>
  322. RR\tx1200
  323. RR{\f2\b Syntax:\tab
  324. RRcenter \{<expression>\}\line\tab
  325. RRcentre \{<expression>\}\par
  326. RR}\pard\par
  327.  
  328. ATThe RasMol 
  329. ACcentre
  330. ATcommand defines the point about which the 
  331. AXrotate rotate
  332. ATcommand and the scroll bars rotate the current molecule. Without a 
  333. ATparameter the centre command resets the centre of rotation to be the
  334. ATcentre of gravity of the molecule. If an atom expression is specified,
  335. ATRasMol rotates the molecule about the centre of gravity of the set of
  336. ATatoms specified by the expression. Hence, if a single atom is specified
  337. ATby the expression, that atom will remain `stationary' during rotations.
  338. AP
  339. ATType 
  340. AXhelp help expression
  341. ATfor more information on RasMol atom expressions.
  342. AB
  343.  
  344. PR?color
  345. RR#{\footnote color}
  346. ASColour
  347. NRSyntax:  colour {<object>} <colour>
  348. NR         color {<object>} <colour>
  349. NR
  350. HR<pre>
  351. HRSyntax:  colour {<object>} <colour>
  352. HR         color {<object>} <colour>
  353. HR</pre><p>
  354. RR\tx1200
  355. RR{\f2\b Syntax:\tab
  356. RRcolour \{<object>\} <colour>\line\tab
  357. RRcolor \{<object>\} <colour>\par
  358. RR}\pard\par
  359.  
  360. ATColour the atoms (or other objects) of the selected zone. The colour may 
  361. ATbe given as either a colour name or a comma separated triple of Red, Green
  362. ATand Blue (RGB) components enclosed in square brackets. Typing the command
  363. AXhelp help colours
  364. ATwill give a list of all the predefined colour names recognised
  365. ATby RasMol.
  366. AP
  367.  
  368. ATAllowed objects are 
  369. ACatoms,
  370. ACbonds,
  371. AXbackbone backbone,
  372. AXhbonds hbonds,
  373. AXribbons ribbons
  374. ATand
  375. AXssbonds ssbonds.
  376. ATIf no object is specified, the default keyword 
  377. ACatom
  378. ATis assumed.
  379. ATSome colour schemes are defined for certain object types. The colour scheme
  380. ACnone
  381. ATcan be applied all objects accept atoms, stating that the selected
  382. ATobjects have no colour of their own, but use the colour of their associated
  383. ATatoms (i.e. the atoms they connect).
  384. ACAtom 
  385. ATobjects can also be coloured by
  386. AXaminocolours amino,
  387. AXcpkcolours cpk,
  388. AXchaincolours chain,
  389. AXgroupcolours group,
  390. AXshapelycolours shapely,
  391. AXstructurecolours structure,
  392. AXtemperaturecolours temperature
  393. ATand
  394. AXusercolours user
  395. ATand hydrogen bond objects can also be coloured by 
  396. AXhbondtypecolours type.
  397. ATFor more information type
  398. AXchcolours help colour <colour>.
  399. AB
  400.  
  401. PR?hbond
  402. RR#{\footnote hbond}
  403. ASHBonds
  404. NRSyntax:  hbonds {<boolean>}
  405. NR         hbonds <value>
  406. NR
  407. HR<pre>
  408. HRSyntax:  hbonds {<boolean>}
  409. HR         hbonds <value>
  410. HR</pre><p>
  411. RR\tx1200
  412. RR{\f2\b Syntax:\tab
  413. RRhbonds \{<boolean>\}\line\tab
  414. RRhbonds <value>\par
  415. RR}\pard\par
  416.  
  417. ATThe RasMol 
  418. AChbond
  419. ATcommand is used to represent the hydrogen bonding of the protein 
  420. ATmolecule's backbone. This information is useful in assessing the
  421. ATprotein's secondary structure. Hydrogen bonds are represented as
  422. ATeither dotted lines or cylinders between the donor and acceptor
  423. ATresidues. The first time the
  424. AChbond
  425. ATcommand is used, the program searches the structure of the 
  426. ATmolecule to find hydrogen bonded residues and reports the number of bonds 
  427. ATto the user. The command
  428. AChbonds on
  429. ATdisplays the selected `bonds' as dotted lines, and the
  430. AChbonds off
  431. ATturns off their display. The colour of hbond objects may be changed 
  432. ATby the
  433. AXcolour colour hbond
  434. ATcommand. Initially, each hydrogen bond has the colours of its connected
  435. ATatoms.
  436. AP
  437.  
  438. ATBy default the dotted lines are drawn between the accepting oxygen and 
  439. ATthe donating nitrogen. By using the
  440. AXsethbonds set hbonds
  441. ATcommand the alpha carbon positions of the appropriate residues may be
  442. ATused instead. This is especially useful when examining proteins in
  443. ATbackbone representation.
  444. AB
  445.  
  446. ASHelp
  447. NRSyntax:  help {<topic> {<subtopic>}}
  448. NR         ? {<topic> {<subtopic>}
  449. NR
  450. HR<pre>
  451. HRSyntax:  help {<topic> {<subtopic>}}
  452. HR         ? {<topic> {<subtopic>}}
  453. HR</pre><p>
  454. RR\tx1200
  455. RR{\f2\b Syntax:\tab
  456. RRhelp \{<topic> \{<subtopic>\}\}\line\tab
  457. RR? \{<topic> \{<subtopic>\}\}\par
  458. RR}\pard\par
  459.  
  460. ATThe RasMol
  461. AChelp
  462. ATcommand provides on-line help on the given topic.
  463. AB
  464.  
  465.  
  466. ASLoad
  467. NRSyntax:  load {pdb} <filename>
  468. NR         load alchemy <filename>
  469. NR
  470. HR<pre>
  471. HRSyntax:  load {pdb} <filename>
  472. HR         load alchemy <filename>
  473. HR</pre><p>
  474. RR\tx1200
  475. RR{\f2\b Syntax:\tab
  476. RRload \{pdb\} <filename>\line\tab
  477. RRload alchemy <filename>\par
  478. RR}\pard\par
  479.  
  480. ATLoad either a Brookhaven Protein Databank (PDB) file or Alchemy(tm) format
  481. ATfile into RasMol2. Only a single PDB file may be loaded at a time. This 
  482. ATcommand selects all the atoms in the molecule, and sets the default 
  483. ATrepresentation to be a cpk coloured wireframe model.
  484. AB
  485.  
  486.  
  487. PR?exit
  488. RR#{\footnote exit}
  489. ASQuit
  490. NRSyntax:  quit
  491. NR         exit
  492. NR
  493. HR<pre>
  494. HRSyntax:  quit
  495. HR         exit
  496. HR</pre><p>
  497. RR\tx1200
  498. RR{\f2\b Syntax:\tab
  499. RRquit\line\tab
  500. RRexit\par
  501. RR}\pard\par
  502.  
  503. ATExit from the RasMol program.
  504. AB
  505.  
  506.  
  507. PR?renum
  508. RR#{\footnote renum}
  509. ASRenumber
  510. NRSyntax:  renumber {{-} <value>}
  511. NR
  512. HR<pre>
  513. HRSyntax:  renumber {{-} <value>}
  514. HR</pre><p>
  515. RR\tx1200
  516. RR{\f2\b Syntax:\tab
  517. RRrenumber \{\{-\} <value>\}\par
  518. RR}\pard\par
  519.  
  520. ATThe RasMol
  521. ACrenumber
  522. ATcommand sequentially numbers the residues in a macromolecular chain.
  523. ATThe optional parameter specifies the value of the first residue in the
  524. ATsequence. By default, this value is one. For proteins,
  525. ATeach amino acid is numbered consecutively from the N terminus to the C 
  526. ATterminus. For nucleic acids, each base is numbered from the 5' terminus 
  527. ATto 3' terminus. All chains in the current database are renumbered and gaps
  528. ATin the original sequence are ignored. The starting value for numbering may
  529. ATbe negative.
  530. AB
  531.  
  532.  
  533. ASReset
  534. NRSyntax:  reset
  535. NR
  536. HR<pre>
  537. HRSyntax:  reset
  538. HR</pre><p>
  539. RR\tx1200
  540. RR{\f2\b Syntax:\tab
  541. RRreset\par
  542. RR}\pard\par
  543.  
  544. ATThe RasMol 
  545. ACreset
  546. ATcommand restores the original viewing transformation
  547. ATand centre of rotation. The scale is set to it default value,
  548. AXzoom zoom 100,
  549. ATthe centre of rotation is set to the geometric centre of the currently 
  550. ATloaded molecule, 
  551. AXcentre centre all,
  552. ATthis centre is translated to the middle of the screen and 
  553. ATthe viewpoint set to the default orientation.
  554. AP
  555.  
  556. ATThis command should not be mistaken for the RasMol
  557. AXzap zap
  558. ATcommand which deletes the currently stored molecule, returning the
  559. ATprogram to its initial state.
  560. AB
  561.  
  562. ASRestrict
  563. NRSyntax:  restrict {<expression>}
  564. NR
  565. HR<pre>
  566. HRSyntax:  restrict {<expression>}
  567. HR</pre><p>
  568. RR\tx1200
  569. RR{\f2\b Syntax:\tab
  570. RRrestrict \{<expression>\}\par
  571. RR}\pard\par
  572.  
  573. ATThe RasMol
  574. ACrestrict
  575. ATcommand both defines the currently active zone of the
  576. ATmolecule and disables the representation of (most of) those parts of the
  577. ATmolecule no longer selected.  All subsequent RasMol commands that modify
  578. ATa molecule's colour or representation effect only the currently selected
  579. ATzone. The parameter of a 
  580. ACrestrict
  581. ATcommand is a RasMol atom expression that is evaluated for every atom
  582. ATof the current molecule. This command is very similar to the RasMol
  583. AXselect select
  584. ATcommand, except restrict disables the
  585. AXwireframe wireframe,
  586. AXspacefill spacefill
  587. ATand
  588. AXbackbone backbone
  589. ATrepresentations in the non-active zone.
  590. AP
  591.  
  592. ATType "help expression" for more information on RasMol atom expressions.
  593. AB
  594.  
  595.  
  596. PR?ribbon
  597. RR#{\footnote ribbon}
  598. ASRibbons
  599. NRSyntax:  ribbons {<boolean>}
  600. NR         ribbons <value>
  601. NR
  602. HR<pre>
  603. HRSyntax:  ribbons {<boolean>}
  604. HR         ribbons <value>
  605. HR</pre><p>
  606. RR\tx1200
  607. RR{\f2\b Syntax:\tab
  608. RRribbons \{<boolean>\}\line\tab
  609. RRribbons <value>\par
  610. RR}\pard\par
  611.  
  612. ATThe RasMol 
  613. ACribbons
  614. ATcommand displays the currently loaded protein as a smooth "ribbon"
  615. ATof depth-cued curves passing along the backbone of the protein. The
  616. ATribbon is composed of a number of strands that run parallel to one
  617. ATanother along the peptide plane of each residue. The ribbon is drawn
  618. ATbetween each amino acid whose alpha carbon is currently selected. 
  619. ATThe colour of the ribbon is changed by the RasMol 
  620. AXcolour colour ribbon
  621. ATcommand. If the current ribbon colour is
  622. ACnone
  623. AT(the default), the colour is taken from the alpha carbon at each
  624. ATposition along its length.
  625. AP
  626.  
  627. ATThe width of the ribbon at each position is determined by the optional
  628. ATparameter in the usual RasMol units. By default this value is 380, which
  629. ATproduces a ribbon 1.52 Angstroms wide. The number of strands in the 
  630. ATribbon may be altered using the RasMol
  631. AXsetstrands set strands
  632. ATcommand. The rendering of the ribbon may also be changed using the
  633. AXsetribbons set ribbons
  634. ATcommand.
  635. AB
  636.  
  637.  
  638. ASRotate
  639. NRSyntax:  rotate <axis> {-} <value>
  640. NR
  641. HR<pre>
  642. HRSyntax:  rotate <axis> {-} <value>
  643. HR</pre><p>
  644. RR\tx1200
  645. RR{\f2\b Syntax:\tab
  646. RRrotate <axis> \{-\} <value>\par
  647. RR}\pard\par
  648.  
  649. ATRotate the molecule about the specified axis. 
  650. ATPermited values for the axis parameter are
  651. HT"<tt><b>x</b></tt>", "<tt><b>y</b></tt>" and "<tt><b>z</b></tt>".
  652. RT"{\f2\b x}", "{\f2\b y}" and "{\f2\b z}".
  653. MT"x", "y" and "z".
  654. NT"x", "y" and "z".
  655. ATThe integer parameter states the angle in degrees for the structure to 
  656. ATbe rotated. For the X and Y axes, positive values move the closest point 
  657. ATup and right, and negative values move it down and left respectively. For 
  658. ATthe Z axis, a positive rotation acts clockwise and a negative angle 
  659. ATanti-clockwise.
  660. AB
  661.  
  662. ASSave
  663. NRSyntax:  save {pdb} <filename>
  664. NR         save alchemy <filename>
  665. NR
  666. HR<pre>
  667. HRSyntax:  save {pdb} <filename>
  668. HR         save alchemy <filename>
  669. HR</pre><p>
  670. RR\tx1200
  671. RR{\f2\b Syntax:\tab
  672. RRsave \{pdb\} <filename>\line\tab
  673. RRsave alchemy <filename>\par
  674. RR}\pard\par
  675.  
  676. ATSave the currently selected set of atoms in either a Brookhaven Protein 
  677. ATDatabase (PDB) or Alchemy(tm) format file.  This command should not be
  678. ATconfused with the RasMol
  679. AXwrite write
  680. ATcommand which generates either image or script files.
  681. AB
  682.  
  683. ASScript
  684. NRSyntax:  script <filename>
  685. NR
  686. HR<pre>
  687. HRSyntax:  script <filename>
  688. HR</pre><p>
  689. RR\tx1200
  690. RR{\f2\b Syntax:\tab
  691. RRscript <filename>\par
  692. RR}\pard\par
  693.  
  694. ATThe RasMol
  695. ACscript
  696. ATcommand reads a set of commands sequentially from a 
  697. ATtext file and executes them. This allows sequences of commonly used 
  698. ATcommands to be stored and performed by a single command. A RasMol script
  699. ATfile may contain a further script command up to a maximum "depth" of 10, 
  700. ATallowing compilicated sequences of actions to be executed.
  701. AB
  702.  
  703. ASSelect
  704. NRSyntax:  select {<expression>}
  705. NR
  706. HR<pre>
  707. HRSyntax:  select {<expression>}
  708. HR</pre><p>
  709. RR\tx1200
  710. RR{\f2\b Syntax:\tab
  711. RRselect \{<expression>\}\par
  712. RR}\pard\par
  713.  
  714. ATDefine the currently active zone of the molecule. All subsequent RasMol
  715. ATcommands that manipulate a molecule or modify its colour or representation,
  716. ATonly effects the currently selected zone. The parameter of a
  717. ACselect
  718. ATcommand is a RasMol expression that is evaluated for every atom of the
  719. ATcurrent molecule. The currently selected (active) zone of the molecule
  720. ATare those atoms that cause the expression to evaluate true. To select
  721. ATthe whole molecule use the RasMol command
  722. ACselect all.
  723. AP
  724.  
  725. ATType "help expression" for more information on RasMol atom expressions.
  726. AB
  727.  
  728. ASSet
  729. NRSyntax:  set <parameter> {<option>}
  730. NR
  731. HR<pre>
  732. HRSyntax:  set <parameter> {<option>}
  733. HR</pre><p>
  734. RR\tx1200
  735. RR{\f2\b Syntax:\tab
  736. RRset <parameter> \{<option>\}\par
  737. RR}\pard\par
  738.  
  739. ATThe RasMol
  740. ACset
  741. ATcommand allows the user to alter various internal program parameters
  742. ATsuch as those controlling rendering options. Each parameter has its
  743. ATown set or permissible parameter options. Typically, ommiting the
  744. ATparamter option resets that parameter to its default value. A list of 
  745. ATvalid parameter names is given below. For more information on each 
  746. ATinternal parameter type
  747. AXhelp help set <parameter>.
  748. AP
  749.  
  750. PR    ambient         background      bondmode        display
  751. PR    hbond           hetero          hourglass       hydrogen
  752. PR    mouse           ribbons         shadow          slabmode
  753. PR    specular        specpower       ssbonds         strands
  754.  
  755. HR<pre>
  756. HR    <a href="#setambient">Ambient</a 
  757. HR>        <a href="#setbackground">Background</a
  758. HR>    <a href="#setbondmode">BondMode</a>
  759. HR    <a href="#sethbonds">HBonds</a
  760. HR>        <a href="#sethetero">Hetero</a
  761. HR>        <a href="#sethourglass">HourGlass</a>
  762. HR    <a href="#sethydrogen">Hydrogen</a
  763. HR>    <a href="#setmouse">Mouse</a
  764. HR>        <a href="#setshadow">Shadow</a>
  765. HR    <a href="#setslabmode">SlabMode</a
  766. HR>    <a href="#setspecular">Specular</a
  767. HR>    <a href="#setspecpower">SpecPower</a>
  768. HR    <a href="#setssbonds">SSBonds</a
  769. HR>        <a href="#setstrands">Strands</a>
  770. HR</pre>
  771.  
  772. RR\cellx1200\cellx2400\cellx3600\cellx4800
  773. RR\intbl
  774. RR{\uldb ambient}{\v setambient}\cell
  775. RR{\uldb background}{\v setbackground}\cell
  776. RR{\uldb bondmode}{\v setbondmode}\cell
  777. RR{\uldb hbonds}{\v sethbonds}\cell
  778. RR\row\intbl
  779. RR{\uldb hetero}{\v sethetero}\cell
  780. RR{\uldb hourglass}{\v sethourglass}\cell
  781. RR{\uldb hydrogen}{\v sethydrogen}\cell
  782. RR{\uldb mouse}{\v setmouse}\cell
  783. RR\row\intbl
  784. RR{\uldb shadow}{\v setshadow}\cell
  785. RR{\uldb slabmode}{\v setslabmode}\cell
  786. RR{\uldb specular}{\v setspecular}\cell
  787. RR{\uldb specpower}{\v setspecpower}\cell
  788. RR\row\intbl
  789. RR{\uldb ssbonds}{\v setssbonds}\cell
  790. RR{\uldb strands}{\v setstrands}\cell
  791. RR\row\pard\par
  792. AB
  793.  
  794. ASShow
  795. NRSyntax:  show information
  796. NR         show sequence
  797. NR
  798. HR<pre>
  799. HRSyntax:  show information
  800. HR         show sequence
  801. HR</pre><p>
  802. RR\tx1200
  803. RR{\f2\b Syntax:\tab
  804. RRshow information\line\tab
  805. RRshow sequence\par
  806. RR}\pard\par
  807.  
  808. ATThe RasMol
  809. ACshow
  810. ATcommand display details of the status of the currently
  811. ATloaded molecule. The command
  812. ACshow information
  813. ATlists the molecule's name,
  814. ATclassification, PDB code and the number of atoms, chains, groups it contains.
  815. ATIf hydrogen bonding, disulphide bridges or secondary structure have been
  816. ATdetermined, the number of hbonds, ssbonds, helices, ladders and turns
  817. ATare also displayed respectively. The command
  818. ACshow sequence
  819. ATlists the residues that compose each chain of the molecule.
  820. AB
  821.  
  822. ASSlab
  823. NRSyntax:  slab {<boolean>}
  824. NR         slab <value>
  825. NR
  826. HR<pre>
  827. HRSyntax:  slab {<boolean>}
  828. HR         slab <value>
  829. HR</pre><p>
  830. RR\tx1200
  831. RR{\f2\b Syntax:\tab
  832. RRslab \{<boolean>\}\line\tab
  833. RRslab <value>\par
  834. RR}\pard\par
  835.  
  836. ATThe RasMol
  837. ACslab
  838. ATcommand enables, disables or positions the z-clipping plane of the
  839. ATmolecule. The program only draws those portions of the 
  840. ATmolecule that are further from the viewer than the slabbing plane. 
  841. ATInteger values range  from zero at the very back of the molecule to 
  842. AT100 which is completely in front of the molecule. Intermediate values 
  843. ATdetermine the percentage of the molecule to be drawn.
  844. AB
  845.  
  846. ASSpacefill
  847. NRSyntax:  spacefill {<boolean>}
  848. NR         spacefill temperature
  849. NR         spacefill user
  850. NR         spacefill <value>
  851. NR
  852. HR<pre>
  853. HRSyntax:  spacefill {<boolean>}
  854. HR         spacefill temperature
  855. HR         spacefill user
  856. HR         spacefill <value>
  857. HR</pre><p>
  858. RR\tx1200
  859. RR{\f2\b Syntax:\tab
  860. RRspacefill \{<boolean>\}\line\tab
  861. RRspacefill temperature\line\tab
  862. RRspacefill user\line\tab
  863. RRspacefill <value>\par
  864. RR}\pard\par
  865.  
  866. ATRepresent the currently selected zone as a spacefilling union of spheres
  867. ATmodel. An integer parameter may be used to specify the radius of each 
  868. ATatom given in 4nm units. If no parameter is given, each atom is drawn as 
  869. ATa sphere of its Van der Waals radius.
  870. AP
  871.  
  872. ATThe
  873. ACtemperature
  874. AToption is used to set the radius of each selected sphere
  875. ATto the value in the temperature field of the molecule file. A zero or
  876. ATnegative value causes no change in the selected atom. Temperature values
  877. ATgreater than 2.00 are truncated to 2.00 Angstrom radius.
  878. AP
  879.  
  880. ATThe
  881. ACuser
  882. AToption allows the radius of the selected spheres to be determined
  883. ATby matching each atom against optional lines in the input data file. Details
  884. ATof the wildcard pattern matching used by Raster3D's COLOR records is given 
  885. ATin the manual.
  886. AB
  887.  
  888.  
  889. PR?ssbond
  890. RR#{\footnote ssbond}
  891. ASSSBonds
  892. NRSyntax:  ssbonds {<boolean>}
  893. NR         ssbonds <value>
  894. NR
  895. HR<pre>
  896. HRSyntax:  ssbonds {<boolean>}
  897. HR         ssbonds <value>
  898. HR</pre><p>
  899. RR\tx1200
  900. RR{\f2\b Syntax:\tab
  901. RRssbonds \{<boolean>\}\line\tab
  902. RRssbonds <value>\par
  903. RR}\pard\par
  904.  
  905. ATThe RasMol 
  906. ACssbonds
  907. ATcommand is used to represent the disulphide bridges of the protein
  908. ATmolecule as either dotted lines or cylinders between the connected 
  909. ATcysteines. The first time that the
  910. ACssbonds
  911. ATcommand is used, the program searches the structure of the protein to 
  912. ATfind half-cysteine pairs (cysteines whose sulphurs are within 3 angstroms
  913. ATof each other) and reports the number of bridges to the user. The command 
  914. ACssbonds on
  915. ATdisplays the selected `bonds' as dotted lines, and the command
  916. ACssbonds off
  917. ATdisables the display of ssbonds in the currently selected area. Selection
  918. ATof disulphide bridges is identical to normal bonds, and may be adjusted
  919. ATusing the RasMol
  920. AXsetbondmode set bondmode
  921. ATcommand. The colour of disulphide bonds may be changed using the 
  922. AXcolour colour ssbonds
  923. ATcommand. By default, each disulphide bond has the colours of its connected 
  924. ATatoms.
  925. AP
  926.  
  927. ATBy default disulphide bonds are drawn between the sulphur atoms within
  928. ATthe cysteine groups. By using the 
  929. AXsetssbonds set ssbonds
  930. ATcommand the position of the cysteine's alpha carbons may be used instead. 
  931. AB
  932.  
  933.  
  934. ASStructure
  935. NRSyntax:  structure
  936. NR
  937. HR<pre>
  938. HRSyntax:  structure
  939. HR</pre><p>
  940. RR\tx1200
  941. RR{\f2\b Syntax:\tab
  942. RRstructure\par
  943. RR}\pard\par
  944.  
  945. ATThe RasMol
  946. ACstructure
  947. ATcommand calculates secondary structure assignments
  948. ATfor the currently loaded protein. If the original PDB file contained 
  949. ATstructural assignment records (HELIX and SHEET) these are discarded.
  950. ATInitially, the hydrogen bonds of the current molecule are found, if this
  951. AThasn't been done already. The secondary structure is the determined using
  952. ATKabsch and Sander's DSSP algorithm. Once finished the program reports the
  953. ATnumber of helices and ladders found.
  954. AB
  955.  
  956.  
  957. ASTranslate
  958. NRSyntax:  translate <axis> {-} <value>
  959. NR
  960. HR<pre>
  961. HRSyntax:  translate <axis> {-} <value>
  962. HR</pre><p>
  963. RR\tx1200
  964. RR{\f2\b Syntax:\tab
  965. RRtranslate <axis> \{-\} <value>\par
  966. RR}\pard\par
  967.  
  968. ATThe RasMol
  969. ACtranslate
  970. ATcommand moves the position of the centre of the molecule on the
  971. ATscreen. The axis parameter specifies along which axis the molecule
  972. ATis to be moved and the integer parameter specifies the absolute
  973. ATposition of the molecule centre from the middle of the screen. 
  974. ATPermited values for the axis parameter are 
  975. HT"<tt><b>x</b></tt>", "<tt><b>y</b></tt>" and "<tt><b>z</b></tt>".
  976. RT"{\f2\b x}", "{\f2\b y}" and "{\f2\b z}".
  977. MT"x", "y" and "z".
  978. NT"x", "y" and "z".
  979.  
  980. ATDisplacement values must be between -100 and 100 which correspond to
  981. ATmoving the current molecule just off the screen. A positive
  982. HT"<tt><b>x</b></tt>"
  983. RT"{\f2\b x}"
  984. MT"x"
  985. NT"x"
  986. ATdisplacement moves the molecule to the right, and a positive
  987. HT"<tt><b>y</b></tt>"
  988. RT"{\f2\b y}"
  989. MT"y"
  990. NT"y"
  991. ATdisplacement moves the molecule down the screen. The pair of commands
  992. ACtranslate x 0
  993. ATand
  994. ACtranslate y 0
  995. ATcentres the molecule on the screen.
  996. AB
  997.  
  998.  
  999. ASWireframe
  1000. NRSyntax:  wireframe {<boolean>}
  1001. NR         wireframe <value>
  1002. NR
  1003. HR<pre>
  1004. HRSyntax:  wireframe {<boolean>}
  1005. HR         wireframe <value>
  1006. HR</pre><p>
  1007. RR\tx1200
  1008. RR{\f2\b Syntax:\tab
  1009. RRwireframe \{<boolean>\}\line\tab
  1010. RRwireframe <value>\par
  1011. RR}\pard\par
  1012.  
  1013. ATRepresent each bond within the selected zone of the molecule as either 
  1014. ATa cylinder or depth-cued vector. If no parameter is given, RasMol draws 
  1015. ATeach bond as a hither-and-yon shaded narrow vector. An integer parameter
  1016. ATspecifies the radius of a cylinder, given in 4nm units, to be used as a
  1017. ATstick bond.
  1018. AB
  1019.  
  1020. ASWrite
  1021. NRSyntax:  write {<format>} <filename>
  1022. NR
  1023. HR<pre>
  1024. HRSyntax:  write {<format>} <filename>
  1025. HR</pre><p>
  1026. RR\tx1200
  1027. RR{\f2\b Syntax:\tab
  1028. RRwrite \{<format>\} <filename>\par
  1029. RR}\pard\par
  1030.  
  1031. ATWrite the current image to a file in a standard raster format. Currently 
  1032. ATsupported file formats include 
  1033. AC"gif 
  1034. AT(Compuserve GIF),
  1035. AC"ppm
  1036. AT(Portable Pixmap), 
  1037. AC"ras
  1038. AT(Sun rasterfile), 
  1039. AC"ps
  1040. ATand
  1041. AC"epsf
  1042. AT(Encapsulated PostScript), 
  1043. AC"monops
  1044. AT(Monochrome Encapsulated PostScript) and 
  1045. AC"bmp
  1046. AT(Microsoft bitmap). This command should not be confused with the RasMol
  1047. AXsave save
  1048. ATcommand which save the currently selected portion of the molecule.
  1049. AB
  1050.  
  1051. ASZap
  1052. NRSyntax:  zap
  1053. NR
  1054. HR<pre>
  1055. HRSyntax:  zap
  1056. HR</pre><p>
  1057. RR\tx1200
  1058. RR{\f2\b Syntax:\tab
  1059. RRzap\par
  1060. RR}\pard\par
  1061.  
  1062. ATDeletes the contents of the current database and resets parameter 
  1063. ATvariables to their initial default state.
  1064. AB
  1065.  
  1066.  
  1067. ASZoom
  1068. NRSyntax:  zoom {<boolean>}
  1069. NR         zoom <value>
  1070. NR
  1071. HR<pre>
  1072. HRSyntax:  zoom {<boolean>}
  1073. HR         zoom <value>
  1074. HR</pre><p>
  1075. RR\tx1200
  1076. RR{\f2\b Syntax:\tab
  1077. RRzoom \{<boolean>\}\line\tab
  1078. RRzoom <value>\par
  1079. RR}\pard\par
  1080.  
  1081. ATChange the magnification of the currently displayed image. Boolean 
  1082. ATparameters either magnify or reset the scale of current molecule. An 
  1083. ATinteger parameter between 10 and 200 specifies the desired magnification 
  1084. ATas a percentage of the default scale.
  1085. AB
  1086.  
  1087. TR    INTERNAL PARAMETERS
  1088. TR    ===================
  1089. TR
  1090. PR?parameters
  1091. PR?set parameters
  1092. PR?internal parameters
  1093. PRInternal Parameters
  1094. RR#{\footnote chsetopt}
  1095. RR${\footnote Internal Parameters}
  1096. RR{\fs24\b Internal Parameters}\par\par
  1097. MR.SH SET PARAMETERS
  1098. HR<a name="chsetopt"><h2>Internal Parameters</h2></a>
  1099.  
  1100. ATRasMol has a number of internal parameters that may be modified using the
  1101. AXset set
  1102. ATcommand. These parameters control a number of program options such as
  1103. ATrendering options and mouse button mappings.
  1104. AP
  1105.  
  1106. PTA complete list of internal parameter names is given below. Type "help
  1107. PTset <parametername>" for more information on each option.
  1108. PP
  1109.  
  1110. HTA complete list of internal parameter names is given below.
  1111. HP
  1112.  
  1113. RTA complete list of internal parameter names is given below.
  1114. RP
  1115.  
  1116. PR    ambient         background      bondmode        display
  1117. PR    hbond           hetero          hourglass       hydrogen
  1118. PR    mouse           ribbons         shadow          slabmode
  1119. PR    specular        specpower       ssbonds         strands
  1120.  
  1121. HR<pre>
  1122. HR    <a href="#setambient">Ambient</a 
  1123. HR>        <a href="#setbackground">Background</a
  1124. HR>    <a href="#setbondmode">BondMode</a>
  1125. HR    <a href="#sethbonds">HBonds</a
  1126. HR>        <a href="#sethetero">Hetero</a
  1127. HR>        <a href="#sethourglass">HourGlass</a>
  1128. HR    <a href="#sethydrogen">Hydrogen</a
  1129. HR>    <a href="#setmouse">Mouse</a
  1130. HR>        <a href="#setshadow">Shadow</a>
  1131. HR    <a href="#setslabmode">SlabMode</a
  1132. HR>    <a href="#setspecular">Specular</a
  1133. HR>    <a href="#setspecpower">SpecPower</a>
  1134. HR    <a href="#setssbonds">SSBonds</a
  1135. HR>        <a href="#setstrands">Strands</a>
  1136. HR</pre>
  1137.  
  1138. RR\cellx1200\cellx2400\cellx3600\cellx4800
  1139. RR\intbl
  1140. RR{\uldb ambient}{\v setambient}\cell
  1141. RR{\uldb background}{\v setbackground}\cell
  1142. RR{\uldb bondmode}{\v setbondmode}\cell
  1143. RR{\uldb hbonds}{\v sethbonds}\cell
  1144. RR\row\intbl
  1145. RR{\uldb hetero}{\v sethetero}\cell
  1146. RR{\uldb hourglass}{\v sethourglass}\cell
  1147. RR{\uldb hydrogen}{\v sethydrogen}\cell
  1148. RR{\uldb mouse}{\v setmouse}\cell
  1149. RR\row\intbl
  1150. RR{\uldb shadow}{\v setshadow}\cell
  1151. RR{\uldb slabmode}{\v setslabmode}\cell
  1152. RR{\uldb specular}{\v setspecular}\cell
  1153. RR{\uldb specpower}{\v setspecpower}\cell
  1154. RR\row\intbl
  1155. RR{\uldb ssbonds}{\v setssbonds}\cell
  1156. RR{\uldb strands}{\v setstrands}\cell
  1157. RR\row\pard\par
  1158. AB
  1159.  
  1160. PR?ambient
  1161. ASSet Ambient
  1162. RRK{\footnote ambient}
  1163. NRSyntax:  set ambient {<value>}
  1164. NR
  1165. HR<pre>
  1166. HRSyntax:  set ambient {<value>}
  1167. HR</pre><p>
  1168. RR\tx1200
  1169. RR{\f2\b Syntax:\tab
  1170. RRset ambient \{<value>\}\par
  1171. RR}\pard\par
  1172.  
  1173. ATThe RasMol
  1174. ACambient
  1175. ATparameter is used to control the amount of ambient (or surrounding)
  1176. ATlight in the scene. The
  1177. ACambient
  1178. ATvalue must be between 0 and 100 that controls the percentage intensity
  1179. ATof the darkest shade of an object. For a solid object, this is the
  1180. ATintensity of surfaces facing away from the light source or in shadow.
  1181. ATFor depth-cued objects this is the intensity of objects furthest from
  1182. ATthe viewer.
  1183. AP
  1184. ATThis parameter is commonly used to correct for monitors with different
  1185. AT"gamma values" (brightness), to change how light or dark a hardcopy
  1186. ATimage appears when printed or to alter the feeling of depth for
  1187. ATwireframe or ribbon representations.
  1188. AB
  1189.  
  1190.  
  1191. ASSet Background
  1192. RRK{\footnote background}
  1193. NRSyntax:  set background <colour>
  1194. NR
  1195. HR<pre>
  1196. HRSyntax:  set background {<colour>}
  1197. HR</pre><p>
  1198. RR\tx1200
  1199. RR{\f2\b Syntax:\tab
  1200. RRset background <colour>\par
  1201. RR}\pard\par
  1202.  
  1203. ATThe RasMol
  1204. ACbackground
  1205. ATparameter is used to set the colour of the "canvas" background. The
  1206. ATcolour may be given as either a colour name or a comma separated
  1207. ATtriple of Red, Green, Blue (RGB) components enclosed in square
  1208. ATbrackets. Typing the command
  1209. AXhelp help colours
  1210. ATwill give a list of the predefined colour names recognised by RasMol.
  1211. ATWhen running under X Windows, RasMol also recognises colours in the
  1212. ATX server's colour name database.
  1213. AB
  1214.  
  1215.  
  1216. PR?bondmode
  1217. ASSet BondMode
  1218. RRK{\footnote bondmode}
  1219. NRSyntax:  set bondmode and
  1220. NR         set bondmode or
  1221. NR
  1222. HR<pre>
  1223. HRSyntax:  set bondmode and
  1224. HR         set bondmode or
  1225. HR</pre><p>
  1226. RR\tx1200
  1227. RR{\f2\b Syntax:\tab
  1228. RRset bondmode and\line\tab
  1229. RRset bondmode or\par
  1230. RR}\pard\par
  1231.  
  1232. ATset bondmode
  1233. AB
  1234.  
  1235.  
  1236. ASSet Display
  1237. RRK{\footnote display}
  1238. NRSyntax:  set display selected
  1239. NR         set display normal
  1240. NR
  1241. HR<pre>
  1242. HRSyntax:  set display selected
  1243. HR         set display normal
  1244. HR</pre><p>
  1245. RR\tx1200
  1246. RR{\f2\b Syntax:\tab
  1247. RRset display selected\line\tab
  1248. RRset display normal\par
  1249. RR}\pard\par
  1250.  
  1251. ATset display
  1252. AB
  1253.  
  1254.  
  1255. ASSet HBonds
  1256. RRK{\footnote hbonds}
  1257. RRK{\footnote sidechain}
  1258. RRK{\footnote backbone}
  1259. NRSyntax:  set hbonds backbone
  1260. NR         set hbonds sidechain
  1261. NR
  1262. HR<pre>
  1263. HRSyntax:  set hbonds backbone
  1264. HR         set hbonds sidechain
  1265. HR</pre><p>
  1266. RR\tx1200
  1267. RR{\f2\b Syntax:\tab
  1268. RRset hbonds backbone\line\tab
  1269. RRset hbonds sidechain\par
  1270. RR}\pard\par
  1271.  
  1272. ATset hbonds
  1273. AB
  1274.  
  1275.  
  1276. ASSet Hetero
  1277. RRK{\footnote hetero}
  1278. NRSyntax:  set hetero <boolean>
  1279. NR
  1280. HR<pre>
  1281. HRSyntax:  set hetero <boolean>
  1282. HR</pre><p>
  1283. RR\tx1200
  1284. RR{\f2\b Syntax:\tab
  1285. RRset hetero <boolean>\par
  1286. RR}\pard\par
  1287.  
  1288. ATset hetero
  1289. AB
  1290.  
  1291.  
  1292. ASSet HourGlass
  1293. RRK{\footnote hourglass}
  1294. NRSyntax:  set hourglass <boolean>
  1295. NR
  1296. HR<pre>
  1297. HRSyntax:  set hourglass <boolean>
  1298. HR</pre><p>
  1299. RR\tx1200
  1300. RR{\f2\b Syntax:\tab
  1301. RRset hourglass \{<boolean>\}\par
  1302. RR}\pard\par
  1303.  
  1304. ATThe RasMol
  1305. AChourglass
  1306. ATparameter allows the user to enable and disable the use of the `hour
  1307. ATglass' cursor used by RasMol to indicate that the program is currently
  1308. ATbusy drawing the next frame. The command
  1309. ACset hourglass on
  1310. ATenable the indicator, whilst
  1311. ACset hourglass off
  1312. ATprevents RasMol from changing the cursor. This is useful when spinning
  1313. ATthe molecule, running a sequence of commands from a script file or
  1314. ATusing interprocess communication to execute complex sequences of
  1315. ATcommands. In these cases a `flashing' cursor may be distracting.
  1316. AB
  1317.  
  1318.  
  1319. ASSet Hydrogen
  1320. RRK{\footnote hydrogen}
  1321. NRSyntax:  set hydrogen <boolean>
  1322. NR
  1323. HR<pre>
  1324. HRSyntax:  set hydrogen <boolean>
  1325. HR</pre><p>
  1326. RR\tx1200
  1327. RR{\f2\b Syntax:\tab
  1328. RRset hydrogen <boolean>\par
  1329. RR}\pard\par
  1330.  
  1331. ATset hydrogen
  1332. AB
  1333.  
  1334.  
  1335. ASSet Mouse
  1336. RRK{\footnote mouse}
  1337. RRK{\footnote rasmol}
  1338. RRK{\footnote insight}
  1339. RRK{\footnote quanta}
  1340. NRSyntax:  set mouse rasmol
  1341. NR         set mouse insight
  1342. NR         set mouse quanta
  1343. NR
  1344. HR<pre>
  1345. HRSyntax:  set mouse rasmol
  1346. HR         set mouse insight
  1347. HR         set mouse quanta
  1348. HR</pre><p>
  1349. RR\tx1200
  1350. RR{\f2\b Syntax:\tab
  1351. RRset mouse rasmol\line\tab
  1352. RRset mouse insight\line\tab
  1353. RRset mouse quanta\par
  1354. RR}\pard\par
  1355.  
  1356. ATThe RasMol
  1357. ACset mouse
  1358. ATcommand sets the rotation, translation, scaling and zooming mouse 
  1359. ATbindings. The default value is
  1360. ACrasmol
  1361. ATwhich is suitable for two button mice (for three button mice the
  1362. ATsecond and third buttons are synonymous); X-Y rotation is controlled
  1363. ATby the first button, and X-Y translation by the second. Additional
  1364. ATfunctions are controlled by holding a modifier key on the keyboard.
  1365. AT[Shift] and the first button performs scaling, [shift] and the second
  1366. ATbutton performs Z-rotation, and [control] and the first mouse button
  1367. ATcontrols the clipping plane. The
  1368. ACinsight
  1369. ATand
  1370. ACquanta
  1371. ATprovide the same mouse bindings as other packages for experienced
  1372. ATusers.
  1373. AB
  1374.  
  1375.  
  1376. ASSet Ribbons
  1377. RRK{\footnote ribbons}
  1378. RRK{\footnote strands}
  1379. RRK{\footnote solid}
  1380. NRSyntax:  set ribbons strands
  1381. NR         set ribbons solid
  1382. NR
  1383. HR<pre>
  1384. HRSyntax:  set ribbons strands
  1385. HR         set ribbons solid
  1386. HR</pre><p>
  1387. RR\tx1200
  1388. RR{\f2\b Syntax:\tab
  1389. RRset ribbons strands\line\tab
  1390. RRset ribbons solid\par
  1391. RR}\pard\par
  1392.  
  1393. ATThe RasMol
  1394. ACset ribbons
  1395. ATcommand controls the way that macromolecular ribbons are displayed.
  1396. ATThe default value
  1397. ACstrands
  1398. ATdisplay macromolecular ribbons as parallel depth-cued strands that
  1399. ATpass along the protein or nucleic acid backbone. The number of strands
  1400. ATin the ribbon may be altered using the RasMol
  1401. AXsetstrands set strands
  1402. ATcommand. The
  1403. ACset ribbons solid
  1404. ATcommand renders the macromolecular ribbon as a solid shaded ribbon.
  1405. AB
  1406.  
  1407.  
  1408. ASSet Shadow
  1409. RRK{\footnote shadow}
  1410. NRSyntax:  set shadow <boolean>
  1411. NR
  1412. HR<pre>
  1413. HRSyntax:  set shadow <boolean>
  1414. HR</pre><p>
  1415. RR\tx1200
  1416. RR{\f2\b Syntax:\tab
  1417. RRset shadow <boolean>\par
  1418. RR}\pard\par
  1419.  
  1420. ATThe RasMol
  1421. ACset shadow
  1422. ATcommand enables and disables raytracing of the currently rendered image.
  1423. ATCurrently only the spacefilling representation is shadowed or can cast
  1424. ATshadows. Enabling shadowing will automatically disable the Z-clipping
  1425. AT(slabbing) plane using the command
  1426. AXslab slab off.
  1427. ATRaytracing typically takes about 10s for a moderately sized protein.
  1428. ATIt is recommended that shadowing is normally disabled whilst the
  1429. ATmolecule is being transformed or manipulated, and only enabled once
  1430. ATan appropiate viewpoint is selected, to provide a greater impression 
  1431. ATof depth.
  1432. AB
  1433.  
  1434.  
  1435. ASSet SlabMode
  1436. RRK{\footnote slabmode}
  1437. RRK{\footnote reject}
  1438. RRK{\footnote half}
  1439. RRK{\footnote hollow}
  1440. RRK{\footnote solid}
  1441. RRK{\footnote section}
  1442. NRSyntax:  set slabmode <slabmode>
  1443. NR
  1444. HR<pre>
  1445. HRSyntax:  set slabmode <slabmode>
  1446. HR</pre><p>
  1447. RR\tx1200
  1448. RR{\f2\b Syntax:\tab
  1449. RRset slabmode <slabmode>\par
  1450. RR}\pard\par
  1451.  
  1452. ATThe RasMol
  1453. ACslabmode
  1454. ATparameter controls the rendering method of objects cut by the 
  1455. ATslabbing (z-clipping) plane. Valid slab modes are
  1456. HT"<tt><b>reject</b></tt>", "<tt><b>half</b></tt>", 
  1457. HT"<tt><b>hollow</b></tt>", "<tt><b>solid</b></tt>" and 
  1458. HT"<tt><b>section</b></tt>".
  1459. RT"{\f2\b reject}", "{\f2\b half}", "{\f2\b hollow}", 
  1460. RT"{\f2\b solid}" and "{\f2\b section}".
  1461. NT"reject", "half", "hollow", "solid" and "section".
  1462. MT"reject", "half", "hollow", "solid" and "section".
  1463. AB
  1464.  
  1465.  
  1466. ASSet Specular
  1467. RRK{\footnote specular}
  1468. NRSyntax:  set specular <boolean>
  1469. NR
  1470. HR<pre>
  1471. HRSyntax:  set specular <boolean>
  1472. HR</pre><p>
  1473. RR\tx1200
  1474. RR{\f2\b Syntax:\tab
  1475. RRset specular <boolean>\par
  1476. RR}\pard\par
  1477.  
  1478. ATThe RasMol
  1479. ACset specular
  1480. ATcommand enables and disables the display of specular highlights on
  1481. ATsolid objects drawn by RasMol. Specular highlights appear as white
  1482. ATreflections of the light source on the surface of the object. The
  1483. ATcurrent RasMol implementation uses an approximation function to
  1484. ATgenerate this highlight.
  1485. AP
  1486.  
  1487. ATThe specular highlights on the surfaces of solid objects may be
  1488. ATaltered by using the specular reflection coefficient, which is
  1489. ATaltered using the RasMol
  1490. AXsetspecpower set specpower
  1491. ATcommand.
  1492. AB
  1493.  
  1494.  
  1495. ASSet SpecPower
  1496. RRK{\footnote specpower}
  1497. NRSyntax:  set specpower {<value>}
  1498. NR
  1499. HR<pre>
  1500. HRSyntax:  set specpower {<value>}
  1501. HR</pre><p>
  1502. RR\tx1200
  1503. RR{\f2\b Syntax:\tab
  1504. RRset specpower \{<value>\}\par
  1505. RR}\pard\par
  1506.  
  1507. ATThe
  1508. ACspecpower
  1509. ATparameter determines the shininess of solid objects rendered by
  1510. ATRasMol. This value between 0 and 100 adjusts the reflection
  1511. ATcoeffient used in specular highlight calculations. The specular
  1512. AThighlights are enabled and disabled by the RasMol
  1513. AXsetspecular set specular
  1514. ATcommand. Values around 20 or 30 produce plastic looking surfaces.
  1515. ATHigh values represent more shiny surfaces such as metals, while
  1516. ATlower values produce more diffuse/dull surfaces.
  1517. AB
  1518.  
  1519.  
  1520. ASSet SSBonds
  1521. RRK{\footnote ssbonds}
  1522. RRK{\footnote backbone}
  1523. RRK{\footnote sidechain}
  1524. NRSyntax:  set ssbonds backbone
  1525. NR         set ssbonds sidechain
  1526. NR
  1527. HR<pre>
  1528. HRSyntax:  set ssbonds backbone
  1529. HR         set ssbonds sidechain
  1530. HR</pre><p>
  1531. RR\tx1200
  1532. RR{\f2\b Syntax:\tab
  1533. RRset ssbonds backbone\line\tab
  1534. RRset ssbonds sidechain\par
  1535. RR}\pard\par
  1536.  
  1537. ATset ssbonds
  1538. AB
  1539.  
  1540.  
  1541. ASSet Strands
  1542. RRK{\footnote strands}
  1543. NRSyntax:  set strands {<value>}
  1544. NR
  1545. HR<pre>
  1546. HRSyntax:  set strands {<value>}
  1547. HR</pre><p>
  1548. RR\tx1200
  1549. RR{\f2\b Syntax:\tab
  1550. RRset strands \{<value>\}\par
  1551. RR}\pard\par
  1552.  
  1553. ATThe RasMol
  1554. ACstrands
  1555. ATparameter controls the number of parallel strands that are displayed
  1556. ATin the ribbon representations of proteins. The permissible values for
  1557. ATthis parameter are 1, 2, 3, 4, 5 and 9. The default value is 5. The
  1558. ATnumber of strands is constant for all ribbons being displayed.
  1559. ATHowever, the ribbon width (the separation between strands) may be
  1560. ATcontrolled on a residue by residue basis using the RasMol
  1561. AXribbons ribbons
  1562. ATcommand.
  1563. AB
  1564.  
  1565.  
  1566. TR    ATOM EXPRESSIONS
  1567. TR    ================
  1568. TR
  1569. PR?expression
  1570. PR?expressions
  1571. PR?atom expressions
  1572. PRAtom Expressions
  1573. RR#{\footnote chexprs}
  1574. RR${\footnote Atom Expressions}
  1575. RR{\fs24\b Atom Expressions}\par\par
  1576. MR.SH ATOM EXPRESSIONS
  1577. HR<a name="chexprs"><h2>Atom Expressions</h2></a>
  1578.  
  1579. ATRasMol atom expressions uniquely identify an arbitrary group of atoms
  1580. ATwithin a molecule. Atom expressions are composed of either primitive
  1581. ATexpressions,
  1582. PT(for more details type "help primitives"),
  1583. ATpredefined sets,
  1584. PT(type "help sets"),
  1585. ATcomparison operators,
  1586. PT("help comparisons"),
  1587. ACwithin
  1588. ATexpressions,
  1589. PT("help within")
  1590. ATor logical (boolean) combinations of the above expression types.
  1591. AP
  1592.  
  1593. ATThe logical operators allow complex queries to be constructed out of
  1594. ATsimpler ones using the standard boolean connectives
  1595. ACand, or
  1596. ATand
  1597. ACnot.
  1598. ATThese may be abbreviated by the symbols
  1599. HT"<tt>&</tt>", "<tt>|</tt>" and "<tt>!</tt>"
  1600. RT"{\f2\b &}", "{\f2\b |}" and "{\f2\b !}"
  1601. MT"&", "|" and "!"
  1602. NT"&", "|" and "!"
  1603. ATrespectively. Parentheses (brackets) may be used to alter the
  1604. ATprecedence of the operators. For convenience, a comma may also
  1605. ATbe used for boolean disjunction. 
  1606. AP
  1607.  
  1608. ATThe atom expression is evaluated for each atom, hence
  1609. ACprotein and backbone
  1610. ATselects protein bacbone atoms, not the protein and [nucleic] acid
  1611. ATbackbone atoms!
  1612. AP
  1613.  
  1614. PRExamples:    backbone and not helix
  1615. PR             within( 800, ser70 )
  1616. PR             not (hydrogen or hetero)
  1617. PR             not *.FE and hetero
  1618. PR             8, 12, 16, 20-28
  1619. PR             arg, his, lys
  1620.  
  1621. HR<ul>
  1622. HR<li><a href="#primitiveexpressions">Primitive Expressions</a>
  1623. HR<li><a href="#predefinedsets">Predefined Sets</a>
  1624. HR<li><a href="#comparisonoperators">Comparison Operators</a>
  1625. HR<li><a href="#withinexpressions"><tt>Within</tt> Expressions</a>
  1626. HR<p><li><a href="#exampleexpressions">Examples</a>
  1627. HR</ul>
  1628.  
  1629. RR\tx250\li250\fi-250
  1630. RR{\f1\'b7}\tab
  1631. RR{\uldb Primitive Expressions}{\v primitiveexpressions}\par
  1632. RR{\f1\'b7}\tab
  1633. RR{\uldb Predefined Sets}{\v predefinedsets}\par
  1634. RR{\f1\'b7}\tab
  1635. RR{\uldb Comparison Operators}{\v comparisonoperators}\par
  1636. RR{\f1\'b7}\tab
  1637. RR{\uldb Within Expressions}{\v withinexpressions}\par\par
  1638. RR{\f1\'b7}\tab
  1639. RR{\uldb Example Expressions}{\v exampleexpressions}\par
  1640. RR\pard
  1641. AB
  1642.  
  1643. ASExample Expressions
  1644. ATThe following table gives some useful examples of RasMol
  1645. ATatom expressions.
  1646. PTFor examples of the precise syntax, type "help expressions".
  1647. AP
  1648.  
  1649. PR    Expression      Interpretation
  1650. PR
  1651. PR    *               All atoms
  1652. PR    cys             Atoms in cysteines
  1653. PR    hoh             Atoms in heterogenous water molecules
  1654. PR    as?             Atoms in either asparagine or aspartic acid 
  1655. PR    *120            Atoms at residue 120 of all chains
  1656. PR    *p              Atoms in chain P
  1657. PR    *.n?            Nitrogen atoms
  1658. PR    cys.sg          Sulphur atoms in cysteine residues
  1659. PR    ser70.c?        Carbon atoms in serine-70
  1660. PR    hem*p.fe        Iron atoms in the Heme groups of chain P
  1661.  
  1662. HR<pre>
  1663. HR    <b>Expression</b>      <b>Interpretation</b>
  1664. HR
  1665. HR    *               All atoms
  1666. HR    cys             Atoms in cysteines
  1667. HR    hoh             Atoms in heterogenous water molecules
  1668. HR    as?             Atoms in either asparagine or aspartic acid 
  1669. HR    *120            Atoms at residue 120 of all chains
  1670. HR    *p              Atoms in chain P
  1671. HR    *.n?            Nitrogen atoms
  1672. HR    cys.sg          Sulphur atoms in cysteine residues
  1673. HR    ser70.c?        Carbon atoms in serine-70
  1674. HR    hem*p.fe        Iron atoms in the Heme groups of chain P
  1675. HR</pre>
  1676.  
  1677.  
  1678. RR\tx1500\li1500\fi-1250
  1679. RR{\b Expression}
  1680. RR\tab{\b Interpretation}\line\par
  1681. RR{\f2\b *}
  1682. RR\tab All atoms\par
  1683. RR{\f2\b cys}
  1684. RR\tab Atoms in cysteines\par
  1685. RR{\f2\b hoh}
  1686. RR\tab Atoms in heterogenous water molecules\par
  1687. RR{\f2\b as?}
  1688. RR\tab Atoms in either asparagine or aspartic acid\par
  1689. RR{\f2\b *120}
  1690. RR\tab Atoms at residue 120 of all chains\par
  1691. RR{\f2\b *p}
  1692. RR\tab Atoms in chain P\par
  1693. RR{\f2\b *.n?}
  1694. RR\tab Nitrogen atoms\par
  1695. RR{\f2\b cys.sg}
  1696. RR\tab Sulphur atoms in cysteine residues\par
  1697. RR{\f2\b ser70.c?}
  1698. RR\tab Carbon atoms in serine-70\par
  1699. RR{\f2\b hem*p.fe}
  1700. RR\tab Iron atoms in the Heme groups of chain P\par 
  1701. RR\par\pard
  1702. AB
  1703.  
  1704. ASPrimitive Expressions
  1705.  
  1706. ATRasMol primitive expressions are the fundamental building blocks
  1707. ATof atom expressions. There a two basic types of primitive expression.
  1708. ATThe first type is used to identify a given residue number or range
  1709. ATof residue numbers. A single residue is identified by its number
  1710. AT(position in the sequence), and a range is specified by lower and
  1711. ATupper bounds separated by a hyphen character. For example
  1712. ACselect 5,6,7,8
  1713. ATis also
  1714. ACselect 5-8.
  1715. ATNote that this selects the given residue numbers in all macromolecule
  1716. ATchains.
  1717. AP
  1718.  
  1719. ATThe second type of primitive expression specifies a sequence of fields
  1720. ATthat must match for a given atom. The first part specifies a residue
  1721. AT(or group of residues) and an optional second part specifies the atoms
  1722. ATwithin those residues. The first part consists of a residue name,
  1723. AToptionally followed by a residue number and/or chain identifier.
  1724. VP
  1725.  
  1726. VTA residue name typically consists of up to three alphabetic characters,
  1727. VTwhich are case insensitive. Hence the primitive expressions
  1728. VCSER
  1729. VTand
  1730. VCser
  1731. VTare equivalent, identifying all cysteine residues.
  1732. VTResidue names that contain non-alphabetic characters, such as
  1733. VTsulphate groups, may be delimited using square brackets, i.e.
  1734. VC[SO4]
  1735. VP
  1736.  
  1737. VTThe residue number is the residue's position in the macromolecule
  1738. VTsequence. Negative sequence numbers are permited. For example,
  1739. VCSER70
  1740. VTCare must be taken when specifying both residue name and number,
  1741. VTit the group at the specified position isn't the specified residue
  1742. VTno atoms are selected.
  1743. VP
  1744.  
  1745. VTThe chain identifier is typically a single case-insensitive 
  1746. VTalphabetic or numeric character. Numeric chain identifiers must
  1747. VTbe distinguished or separated from residue numbers by a colon
  1748. VTcharacter. For example,
  1749. VCSER70A
  1750. VTor
  1751. VCSER70:1
  1752. VP
  1753.  
  1754. ATThe second part consists of a period character followed by an atom
  1755. ATname.
  1756. VTAn atom name may be up to four alphabetic or numeric characters.
  1757. VP
  1758.  
  1759. ATAn asterisk may be used as a wild card for a whole field and a
  1760. ATquestion mark as a single character wildcard.
  1761. PP
  1762.  
  1763. PTFor examples of RasMol expressions type "help examples".
  1764. AB
  1765.  
  1766. PR?comparison
  1767. PR?comparisons
  1768. PR?comparison expressions
  1769. ASComparison Operators
  1770.  
  1771. ATParts of a molecule may also be distinguished using equality,
  1772. ATinequality and ordering operators on their properties. The format
  1773. ATof such comparison expression is a property name, followed by a
  1774. ATcomparison operator and then an integer value.
  1775. AP
  1776. ATThe atom properties that may be used in RasMol are
  1777. ACatomno
  1778. ATfor the atom serial number,
  1779. ACresno
  1780. ATfor the residue number,
  1781. ACradius
  1782. ATfor the spacefill radius in RasMol units (or zero if not represented
  1783. ATas a sphere) and
  1784. ACtemperature
  1785. ATfor the PDB anisotropic temperature value.
  1786. AP
  1787. ATThe equality operator is denoted either
  1788. RT"{\f2\b =}" or "{\f2\b ==}".
  1789. HT"<tt><b>=</b></tt>" or "<tt><b>==</b></tt>".
  1790. NT"=" or "==".
  1791. MT"=" or "==".
  1792. ATThe inequality operator as either
  1793. RT"{\f2\b <>}", "{\f2\b !=}" or "{\f2\b /=}".
  1794. HT"<tt><b><></b></tt>", "<tt><b>!=</b></tt>" or 
  1795. HT"<tt><b>/=</b></tt>".
  1796. NT"<>", "!=" or "/=".
  1797. MT"<>", "!=" or "/=".
  1798. ATThe ordering operators are
  1799. RT"{\f2\b <}"
  1800. HT"<tt><b><</b></tt>"
  1801. NT"<"
  1802. MT"<"
  1803. ATfor less than,
  1804. RT"{\f2\b <=}"
  1805. HT"<tt><b><=</b></tt>"
  1806. NT"<="
  1807. MT"<="
  1808. ATfor less than or equal to,
  1809. RT"{\f2\b >}"
  1810. HT"<tt><b>></b></tt>"
  1811. NT">"
  1812. MT">"
  1813. ATfor greater than, and
  1814. RT"{\f2\b >=}"
  1815. HT"<tt><b>>=</b></tt>"
  1816. NT">"
  1817. MT">"
  1818. ATfor greater than or equal to.
  1819. AP
  1820.  
  1821. PRExamples:    resno < 23
  1822. PR             temperature >= 900
  1823. PR             atomno == 487
  1824.  
  1825. HR<pre>
  1826. HRExamples:    resno < 23
  1827. HR             temperature >= 900
  1828. HR             atomno == 487
  1829. HR</pre>
  1830.  
  1831. RR\tx1500
  1832. RR{\f2\b Examples:
  1833. RR\tab resno < 23\par
  1834. RR\tab temperature >= 900\par
  1835. RR\tab atomno == 487\par
  1836. RR}\pard\par
  1837. AB
  1838.  
  1839. ASWithin Expressions
  1840. RRK{\footnote within}
  1841.  
  1842. ATA RasMol
  1843. ACwithin
  1844. ATexpression allows atoms to be selected on their proximity to
  1845. ATanother set of atoms. A
  1846. ACwithin
  1847. ATexpression takes two parameters separated by a comma and surrounded
  1848. ATby parenthesis. The first argument is an integer value called the
  1849. AT"cut-off" distance of the within expression and the second argument
  1850. ATis any  valid atom expression. The cut-off distance is expressed in
  1851. ATRasMol 0.004 Angstrom units. An atom is selected if it is within
  1852. ATthe cut-off distance of any of the atoms defined by the second 
  1853. ATargument. This allows complex expressions to be constructed containing
  1854. ATnested
  1855. ACwithin
  1856. ATexpressions.
  1857. AP
  1858. ATFor example, the command
  1859. ACselect within(800,backbone)
  1860. ATselects any atom within a 3.2 Angstrom radius of any atom in a 
  1861. ATprotein or nucleic acid backbone.
  1862. ACWithin
  1863. ATexpressions are particularly usefull for selecting the atoms 
  1864. ATaround an active site. 
  1865. AB
  1866.  
  1867. PR?sets
  1868. ASPredefined Sets
  1869. RRK{\footnote sets}
  1870.  
  1871. ATRasMol atom expressions may contain predefined sets. Thsese sets
  1872. ATare single keywords that represent portions of a molecule of interest.
  1873. ATPredefined sets are often abbreviations primitive atom expressions,
  1874. ATand in some cases of selecting areas of a molecule that could not 
  1875. ATotherwise be distinguished. A list of the currently predfined sets
  1876. ATis given below.
  1877. PTType "help sets setname" for more information about a given set.
  1878. AP
  1879.  
  1880. PR    at              acidic          acyclic         aliphatic
  1881. PR    alpha           amino           aromatic        backbone
  1882. PR    basic           buried          cg              charged
  1883. PR    cyclic          cystine         helix           hetero
  1884. PR    hydrogen        hydrophobic     large           medium
  1885. PR    neutral         nucleic         polar           protein
  1886. PR    purine          pyrimidine      selected        sheet
  1887. PR    sidechain       small           surface         turn
  1888. PR    water
  1889.  
  1890. HR<pre>
  1891. HR    <a href="#atset">AT</a 
  1892. HR>        <a href="#acidicset">Acidic</a 
  1893. HR>        <a href="#acyclicset">Acyclic</a>
  1894. HR     <a href="#aliphaticset">Aliphatic</a 
  1895. HR>    <a href="#alphaset">Alpha</a 
  1896. HR>        <a href="#aminoset">Amino</a>
  1897. HR    <a href="#aromaticset">Aromatic</a 
  1898. HR>    <a href="#backboneset">Backbone</a 
  1899. HR>    <a href="#basicset">Basic</a>
  1900. HR    <a href="#buriedset">Buried</a 
  1901. HR>        <a href="#cgset">CG</a 
  1902. HR>        <a href="#chargedset">Charged</a>
  1903. HR    <a href="#cyclicset">Cyclic</a 
  1904. HR>        <a href="#cystineset">Cystine</a 
  1905. HR>        <a href="#helixset">Helix</a>
  1906. HR    <a href="#heteroset">Hetero</a
  1907. HR>        <a href="#hydrogenset">Hydrogen</a 
  1908. HR>    <a href="#hydrophobicset">Hydrophobic</a>
  1909. HR    <a href="#largeset">Large</a 
  1910. HR>        <a href="#mediumset">Medium</a 
  1911. HR>        <a href="#neutralset">Neutral</a>
  1912. HR    <a href="#nucleicset">Nucleic</a
  1913. HR>        <a href="#polarset">Polar</a 
  1914. HR>        <a href="#proteinset">Protein</a>
  1915. HR    <a href="#purineset">Purine</a 
  1916. HR>        <a href="#pyrimidineset">Pyrimidine</a 
  1917. HR>    <a href="#selectedset">Selected</a>
  1918. HR    <a href="#sheetset">Sheet</a 
  1919. HR>        <a href="#sidechainset">Sidechain</a 
  1920. HR>    <a href="#smallset">Small</a>
  1921. HR    <a href="#surfaceset">Surface</a
  1922. HR>        <a href="#turnset">Turn</a
  1923. HR>        <a href="#waterset">Water</a>
  1924. HR</pre>
  1925.  
  1926. RR\cellx1200\cellx2400\cellx3600\cellx4800
  1927. RR\intbl
  1928. RR{\uldb at}{\v atset}\cell
  1929. RR{\uldb acidic}{\v acidicset}\cell
  1930. RR{\uldb acyclic}{\v acyclicset}\cell
  1931. RR{\uldb aliphatic}{\v aliphaticset}\cell
  1932. RR\row\intbl
  1933. RR{\uldb alpha}{\v alphaset}\cell
  1934. RR{\uldb amino}{\v aminoset}\cell
  1935. RR{\uldb aromatic}{\v aromaticset}\cell
  1936. RR{\uldb backbone}{\v backboneset}\cell
  1937. RR\row\intbl
  1938. RR{\uldb basic}{\v basicset}\cell
  1939. RR{\uldb buried}{\v buriedset}\cell
  1940. RR{\uldb cg}{\v cgset}\cell
  1941. RR{\uldb charged}{\v chargedset}\cell
  1942. RR\row\intbl
  1943. RR{\uldb cyclic}{\v cyclicset}\cell
  1944. RR{\uldb cystine}{\v cystineset}\cell
  1945. RR{\uldb helix}{\v helixset}\cell
  1946. RR{\uldb hetero}{\v heteroset}\cell
  1947. RR\row\intbl
  1948. RR{\uldb hydrogen}{\v hydrogenset}\cell
  1949. RR{\uldb hydrophobic}{\v hydrophobicset}\cell
  1950. RR{\uldb large}{\v largeset}\cell
  1951. RR{\uldb medium}{\v mediumset}\cell
  1952. RR\row\intbl
  1953. RR{\uldb neutral}{\v neutralset}\cell
  1954. RR{\uldb nucleic}{\v nucleicset}\cell
  1955. RR{\uldb polar}{\v polarset}\cell
  1956. RR{\uldb protein}{\v proteinset}\cell
  1957. RR\row\intbl
  1958. RR{\uldb purine}{\v purineset}\cell
  1959. RR{\uldb pyrimidine}{\v pyrimidineset}\cell
  1960. RR{\uldb selected}{\v selectedset}\cell
  1961. RR{\uldb sheet}{\v sheetset}\cell
  1962. RR\row\intbl
  1963. RR{\uldb sidechain}{\v sidechainset}\cell
  1964. RR{\uldb small}{\v smallset}\cell
  1965. RR{\uldb surface}{\v surfaceset}\cell
  1966. RR{\uldb turn}{\v turnset}\cell
  1967. RR\row\intbl
  1968. RR{\uldb water}{\v waterset}\cell
  1969. RR\row\pard\par
  1970. AB
  1971.  
  1972. MR.SH Predefined Sets
  1973.  
  1974. ASAT Set
  1975. RRK{\footnote at}
  1976. ATThis set contains the atoms in the complementary nucleotides
  1977. ATadenosine and thymidine (A and T respectively). All nucleotides
  1978. ATare classified as either the set
  1979. ACat
  1980. ATor the set
  1981. AXcgset cg
  1982. ATThis set is equivalent to the RasMol atom expressions
  1983. AC"a,t
  1984. ATand
  1985. AC"nucleic and not cg
  1986. AB
  1987.  
  1988. ASAcidic Set
  1989. RRK{\footnote acidic}
  1990. ATThe set of acidic amino acids. 
  1991. ATThese are the residue types Asp, Glu and Tyr. 
  1992. ATAll amino acids are classified as either 
  1993. ACacidic,
  1994. AXbasicset basic
  1995. ACor
  1996. AXneutralset neutral.
  1997. ATThis set is equivalent to the RasMol atom expressions
  1998. AC"asp, glu, tyr
  1999. ATand
  2000. AC"amino and not (basic or neutral)
  2001. AB
  2002.  
  2003. ASAcyclic Set
  2004. RRK{\footnote acyclic}
  2005. ATThe set of atoms in amino acids not containing a cycle or
  2006. ATring. All amino acids are classified as either
  2007. AXcyclicset cyclic
  2008. ATor
  2009. ACacyclic.
  2010. ATThis set is equivalent to the RasMol atom expression
  2011. AC"amino and not cyclic
  2012. AB
  2013.  
  2014. ASAliphatic Set
  2015. RRK{\footnote aliphatic}
  2016. ATThis set contains the aliphatic amino acids.
  2017. ATThese are the amino acids Ala, Gly, Ile, Leu and Val.
  2018. ATThis set is equiavlent to the RasMol atom expression
  2019. AC"ala, gly, ile, leu, val
  2020. AB
  2021.  
  2022. ASAlpha Set
  2023. RRK{\footnote alpha}
  2024. ATThe set of alpha carbons in the protein molecule. This set is
  2025. ATapproximately equivalent to the RasMol atom expression
  2026. AC"*.CA
  2027. ATThis command should not be confused with the predefined set
  2028. AXhelixset helix
  2029. ATwhich contains the atoms in the amino acids of the protein's
  2030. ATalpha helices.
  2031. AB
  2032.  
  2033. ASAmino Set
  2034. RRK{\footnote amino}
  2035. ATThis set contains all the atoms contained in amino acid residues.
  2036. ATThis is useful for distinguishing the protein from the nucleic
  2037. ATacid and heterogenous atoms in the current molecule database.
  2038. AB
  2039.  
  2040. ASAromatic Set
  2041. RRK{\footnote aromatic}
  2042. ATThe set of atoms in amino acids containing aromatic rings.
  2043. ATThese are the amino acids His, Phe, Trp and Tyr.
  2044. ATBecause they contain aromatic rings all members of this
  2045. ATset are member of the predefined set
  2046. AXcyclicset cyclic.
  2047. ATThis set is equivalent to the RasMol atom expressions
  2048. AC"his, phe, trp, tyr
  2049. ATand
  2050. AC"cyclic and not pro
  2051. AB
  2052.  
  2053. ASBackbone Set
  2054. RRK{\footnote backbone}
  2055. ATThis set contains the four atoms of each amino acid that form the
  2056. ATpolypeptide N-C-C-O backbone of proteins, and the atoms the sugar
  2057. ATphosphate backbone of nucleic acids.
  2058. ATUse the RasMol predefined sets
  2059. ACprotein
  2060. ATand
  2061. ACnucleic
  2062. ATto distinguish between the two forms of backbone. 
  2063. ATAtoms in nucleic acids and proteins are either
  2064. ACbackbone
  2065. ATor
  2066. AXsidechainset sidechain.
  2067. ATThis set is equivalent to the RasMol expression
  2068. AT"(protein or nucleic) and not sidechain
  2069. AB
  2070.  
  2071. ASBasic Set
  2072. RRK{\footnote basic}
  2073. ATThe set of basic amino acids. 
  2074. ATThese are the residue types Asp, Glu and Tyr. 
  2075. ATAll amino acids are classified as either 
  2076. AXacidicset acidic,
  2077. ACbasic
  2078. ATor
  2079. AXneutralset neutral.
  2080. ATThis set is equivalent to the RasMol atom expressions
  2081. AC"asp, glu, tyr
  2082. ATand
  2083. AC"amino and not (acidic or neutral)
  2084. AB
  2085.  
  2086.  
  2087. ASBuried Set
  2088. RRK{\footnote buried}
  2089. ATThis set contains the atoms in those amino acids that tend
  2090. AT(prefer) to buried inside protein, away from contact with
  2091. ATsolvent molecules. This set refers to the amino acids 
  2092. ATpreference and not the actual solvent acessibility for
  2093. ATthe current protein.
  2094. ATAll amino acids are classified as either
  2095. AXsurfaceset surface
  2096. ATor
  2097. ACburied.
  2098. ATThis set is equivalent to the RasMol atom expression
  2099. AC"amino and not surface
  2100. AB
  2101.  
  2102. ASCG Set
  2103. RRK{\footnote cg}
  2104. ATThis set contains the atoms in the complementary nucleotides
  2105. ATcytidine and guanoine (C and G respectively). All nucleotides
  2106. ATare classified as either the set
  2107. AXatset at
  2108. ATor the set
  2109. ACcg
  2110. ATThis set is equivalent to the RasMol atom expressions
  2111. AC"c,g
  2112. ATand
  2113. AC"nucleic and not at
  2114. AB
  2115.  
  2116.  
  2117. ASCharged Set
  2118. RRK{\footnote charged}
  2119. ATThis set contains the charged amino acids. These are the amino
  2120. ATacids that are either
  2121. AXacidicset acidic
  2122. ATor
  2123. AXbasicset basic.
  2124. ATAmino acids are classified as being either
  2125. ACcharged
  2126. ATor
  2127. AXneutralset neutral.
  2128. ATThis set is equivalent to the RasMol atom expressions
  2129. AC"acidic or basic
  2130. ATand
  2131. AC"amino and not neutral
  2132. AB
  2133.  
  2134. ASCyclic Set
  2135. RRK{\footnote cyclic}
  2136. ATThe set of atoms in amino acids containing a cycle or rings.
  2137. ATAll amino acids are classified as either
  2138. ACcyclic
  2139. ATor
  2140. AXacyclicset acyclic.
  2141. ATThis set consists of the amino acids His, Phe, Pro, Trp and Tyr.
  2142. ATThe members of the predefined set
  2143. AXaromaticset aromatic
  2144. ATare members of this set.
  2145. ATThe only cyclic but non-aromatic amino acid is proline.
  2146. ATThis set is equivalent to the RasMol atom expressions
  2147. AC"his, phe, pro, trp, tyr
  2148. ATand
  2149. AC"aromatic or pro
  2150. ATand
  2151. AC"amino and not acyclic
  2152. AB
  2153.  
  2154. ASCystine Set
  2155. RRK{\footnote cystine}
  2156. ATThis set contains the atoms of cysteine residues that form part
  2157. ATof a disulphide bridge, i.e. half cystines. RasMol automatically
  2158. ATdetermines disulphide bridges, if neither the predefined set
  2159. ACcystine
  2160. ATnor the RasMol
  2161. AXssbonds ssbonds
  2162. ATcommand have been used since the molecule was loaded. The set of
  2163. ATfree cysteines may be determined using the RasMol atom expression
  2164. AC"cys and not cystine
  2165. AB
  2166.  
  2167. ASHelix Set
  2168. RRK{\footnote helix}
  2169. ATThis set contains all atoms that form part of a protein alpha
  2170. AThelix as determined by either the PDB file author or Kabsch and 
  2171. ATSander's DSSP algorithm. By default, RasMol uses the secondary
  2172. ATstructure determination given in the PDB file if it exists.
  2173. ATOtherwise, it uses the DSSP algorithm as used by the RasMol
  2174. AXstructure structure
  2175. ATcommand.
  2176. AP
  2177. ATThis command should not be confused with the predefined set
  2178. AXalphaset alpha
  2179. ATwhich contains the alpha carbon atoms of a protein.
  2180. AB
  2181.  
  2182. ASHetero Set
  2183. RRK{\footnote hetero}
  2184. ATThis set contains all the heterogenous atoms in the molecule. These
  2185. ATare the atoms described by HETATM entries in the PDB file. These
  2186. ATtypically contain water, cofactors and other solvents and ligands.
  2187. ATThe RasMol predefined set
  2188. AXwaterset water
  2189. ATis often used to partition this set.
  2190. AB
  2191.  
  2192. ASHydrogen Set
  2193. RRK{\footnote hydrogen}
  2194. ATThis predefined set contains all the hydrogen and deuterium atoms
  2195. ATof the current molecule.
  2196. AB
  2197.  
  2198. ASHydrophobic Set
  2199. RRK{\footnote hydrophobic}
  2200. ATThis set contains all the hydrophobic amino acids.
  2201. ATThese are the amino acids Ala, Leu, Val, Ile, Pro, Phe, Met and Trp.
  2202. ATAll amino acids are classified as either
  2203. AChydrophobic
  2204. ATor
  2205. AXpolarset polar.
  2206. ATThis set is equivalent to the RasMol atom expressions
  2207. AC"ala, leu, val, ile, pro, phe, met, trp
  2208. ATand
  2209. AC"amino and not polar
  2210. AB
  2211.  
  2212. ASLarge Set
  2213. RRK{\footnote large}
  2214. ATAll amino acids are classified as either
  2215. AXsmallset small,
  2216. AXmediumset medium
  2217. ATor
  2218. AClarge.
  2219. ATThis set is equivalent to the RasMol atom expression
  2220. AC"amino and not (small or medium)
  2221. AB
  2222.  
  2223. ASMedium Set
  2224. RRK{\footnote medium}
  2225. ATAll amino acids are classified as either
  2226. AXsmallset small,
  2227. ACmedium
  2228. ATor
  2229. AXlargeset large.
  2230. ATThis set is equivalent to the RasMol atom expression
  2231. AC"amino and not (large or small)
  2232. AB
  2233.  
  2234. ASNeutral Set
  2235. RRK{\footnote neutral}
  2236. ATThe set of neutral amino acids. 
  2237. ATAll amino acids are classified as either 
  2238. AXacidicset acidic,
  2239. ACbasic
  2240. ACor
  2241. AXneutralset neutral.
  2242. ATThis set is equivalent to the RasMol atom expression
  2243. AC"amino and not (acidic or basic)
  2244. AB
  2245.  
  2246.  
  2247. ASNucleic Set
  2248. RRK{\footnote nucleic}
  2249. ATThe set of all atoms in nucleic acids.
  2250. AB
  2251.  
  2252. ASPolar Set
  2253. RRK{\footnote polar}
  2254. ATThis set contains the polar amino acids.
  2255. ATAll amino acids are classified as either
  2256. AXhydrophobicset hydrophobic
  2257. ATor
  2258. ACpolar.
  2259. ATThis set is equivalent to the RasMol atom expression
  2260. AC"amino and not hydrophobic
  2261. AB
  2262.  
  2263. ASProtein Set
  2264. RRK{\footnote protein}
  2265. ATThe set of all atoms in proteins. This consists of the RasMol
  2266. ATpredefined set
  2267. AXaminoset amino
  2268. ATand common post-translation modifications.
  2269. AB
  2270.  
  2271. ASPurine Set
  2272. RRK{\footnote purine}
  2273. ATThe set of purine nucleotides.
  2274. ATThese are the bases adenosine and guanosine (A and G respectively).
  2275. ATAll nucleotides are either
  2276. ACpurines
  2277. ATor
  2278. AXpyrimidineset pyrimidines.
  2279. ATThis set is equivalent to the RasMol atom expressions
  2280. AC"a,g
  2281. ATand
  2282. AC"nucleic and not purine
  2283. AB
  2284.  
  2285. ASPyrimidine Set
  2286. RRK{\footnote pyrimidine}
  2287. ATThe set of pyrimidine nucleotides.
  2288. ATThese are the bases cytidine and thymidine (C and T respectively).
  2289. ATAll nucleotides are either
  2290. ACpurineset purines
  2291. ATor
  2292. ACpyrimidines.
  2293. ATThis set is equivalent to the RasMol atom expressions
  2294. AC"c,t
  2295. ATand
  2296. AC"nucleic and not pyrimidine
  2297. AB
  2298.  
  2299. ASSelected Set
  2300. RRK{\footnote selected}
  2301. ATThis set contains the set of atoms in the currently active zone.
  2302. ATThe currently active zone is defined by the preceding
  2303. AXselect select
  2304. ATor
  2305. AXrestrict restrict
  2306. ATcommand and not the atom expression containing the
  2307. ACselected
  2308. ATkeyword.
  2309. AB
  2310.  
  2311. ASSheet Set
  2312. RRK{\footnote sheet}
  2313. ATThis set contains all atoms that form part of a protein beta
  2314. ATsheet as determined by either the PDB file author or Kabsch and 
  2315. ATSander's DSSP algorithm. By default, RasMol uses the secondary
  2316. ATstructure determination given in the PDB file if it exists.
  2317. ATOtherwise, it uses the DSSP algorithm as used by the RasMol
  2318. AXstructure structure
  2319. ATcommand.
  2320. AB
  2321.  
  2322. ASSidechain Set
  2323. RRK{\footnote sidechain}
  2324. ATThis set contains the functional sidechains of any amino acids
  2325. ATand the base of each nucleotide. These are the atoms not part of
  2326. ATthe polypeptide N-C-C-O backbone of proteins or the sugar
  2327. ATphosphate backbone of nucleic acids.
  2328. ATUse the RasMol predefined sets
  2329. ACprotein
  2330. ATand
  2331. ACnucleic
  2332. ATto distinguish between the two forms of sidechain. 
  2333. ATAtoms in nucleic acids and proteins are either
  2334. AXbackboneset backbone
  2335. ATor
  2336. ACsidechain.
  2337. ATThis set is equivalent to the RasMol expression
  2338. AT"(protein or nucleic) and not backbone
  2339. AB
  2340.  
  2341. ASSmall Set
  2342. RRK{\footnote small}
  2343. ATAll amino acids are classified as either
  2344. ACsmall,
  2345. AXmediumset medium
  2346. ATor
  2347. AXlargeset large.
  2348. ATThis set is equivalent to the RasMol atom expression
  2349. AC"amino and not (medium or large)
  2350. AB
  2351.  
  2352. ASSurface Set
  2353. RRK{\footnote surface}
  2354. ATThis set contains the atoms in those amino acids that tend
  2355. AT(prefer) to be on the surface of proteins, in contact with
  2356. ATsolvent molecules. This set refers to the amino acids 
  2357. ATpreference and not the actual solvent acessibility for
  2358. ATthe current protein.
  2359. ATAll amino acids are classified as either
  2360. ACsurface
  2361. ATor
  2362. AXburiedset buried.
  2363. ATThis set is equivalent to the RasMol atom expression
  2364. AC"amino and not buried
  2365. AB
  2366.  
  2367. ASTurn Set
  2368. RRK{\footnote turn}
  2369. ATThis set contains all atoms that form part of a protein turns
  2370. ATas determined by either the PDB file author or Kabsch and 
  2371. ATSander's DSSP algorithm. By default, RasMol uses the secondary
  2372. ATstructure determination given in the PDB file if it exists.
  2373. ATOtherwise, it uses the DSSP algorithm as used by the RasMol
  2374. AXstructure structure
  2375. ATcommand.
  2376. AB
  2377.  
  2378. ASWater Set
  2379. RRK{\footnote water}
  2380. ATThis set contains all the heterogenous water molecules in the current
  2381. ATdatabase. A large number of water molecules are sometimes associated 
  2382. ATwith protein and nucleic acid structures determined by X-ray 
  2383. ATcrystallography. These atoms tend to clutter an image.
  2384. AB
  2385.  
  2386. TR    Colour Schemes
  2387. TR    ==============
  2388. TR
  2389. PR?colors
  2390. PR?colours
  2391. PR?color schemes
  2392. PR?colour schemes
  2393. PR?color names
  2394. PR?colour names
  2395. PR?predefined colors
  2396. PR?predefined colours
  2397. PRColour Schemes
  2398. RR#{\footnote chcolours}
  2399. RR${\footnote Colour Schemes}
  2400. RR{\fs24\b Colour Schemes}\par\par
  2401. MR.SH COLOUR SCHEMES
  2402. HR<a name="chcolours"><h2>Colour Schemes</h2></a>
  2403.  
  2404. ATThe RasMol
  2405. AXcolour colour
  2406. ATcommand allows different objects (such as atoms, bonds and ribbon segments)
  2407. ATto be given a specified colour. Typically this colour is either a RasMol
  2408. ATpredefined colour name or an RGB triple. Additionally RasMol also supports
  2409. AXaminocolours amino,
  2410. AXchaincolours chain,
  2411. AXgroupcolours group,
  2412. AXshapelycolours shapely,
  2413. AXstructurecolours structure,
  2414. AXtemperaturecolours temperature,
  2415. AXusercolours user
  2416. ATand
  2417. AXhbondtypecolours hbond type
  2418. ATcolour schemes.
  2419. ATThe currently predefined colour
  2420. ATnames are
  2421.  
  2422. PTlisted below with their corresponding RGB triplet.
  2423. PP
  2424. PR    blue         [0,0,255]          black        [0,0,0]
  2425. PR    cyan         [0,255,255]        green        [0,255,0]
  2426. PR    greenblue    [46,139,87]        magenta      [255,0,255]
  2427. PR    orange       [255,165,0]        purple       [160,32,240]
  2428. PR    red          [255,0,0]          redorange    [255,69,0]
  2429. PR    violet       [238,130,238]      white        [255,255,255]
  2430. PR    yellow       [255,255,0]
  2431. AB
  2432.  
  2433. PR?color amino
  2434. PR?colour amino
  2435. ASAmino Colours
  2436. ATThe RasMol
  2437. ACamino
  2438. ATcolour scheme colours amino acids according to traditional amino acid
  2439. ATproperties. The purpose of colouring is to identify amino acids in an
  2440. ATunusual or surprising environment. The outer parts of a protein are
  2441. ATpolar are visible (bright) colours and non-polar residues darker. Most
  2442. ATcolours are hallowed by tradition. This colour scheme is similar to the
  2443. AXshapelycolours shapely
  2444. ATscheme.
  2445. PP
  2446. PR   ASP,GLU bright red [230,10,10]     CYS,MET     yellow [230,230,0]
  2447. PR   LYS,ARG blue       [20,90,255]     SER,THR     orange [250,150,0]
  2448. PR   PHE,TYR mid blue   [50,50,170]     ASN,GLN     cyan   [0,220,220]     
  2449. PR   GLY     light grey [235,235,235]   LEU,VAL,ILE green  [15,130,15]     
  2450. PR   ALA     dark grey  [200,200,200]   TRP         pink   [180,90,180]    
  2451. PR   HIS     pale blue  [130,130,210]   PRO         flesh  [220,150,130]
  2452. AB
  2453.  
  2454. PR?chain
  2455. PR?color chain
  2456. PR?colour chain
  2457. ASChain Colours
  2458. ATThe RasMol
  2459. ACchain
  2460. ATcolour scheme assigns each macromolecular chain a unique colour. This
  2461. ATcolour scheme is particularly usefull for distinguishing the parts of
  2462. ATmultimeric structure or the individual `strands' of a DNA chain. 
  2463. AB
  2464.  
  2465. PR?cpk
  2466. PR?color cpk
  2467. PR?colour cpk
  2468. ASCPK Colours
  2469. ATThe RasMol
  2470. ACcpk
  2471. ATcolour scheme is based upon the colours of the popular plastic
  2472. ATspacefilling models which were developed by Corey, Pauling and later
  2473. ATimproved by Kultun. This colour scheme colour `atom' objects by the
  2474. ATatom (element) type. This is the scheme conventionally used by chemists.
  2475.  
  2476. PTThe assignment of element type to colours is given below.
  2477. PP
  2478. PR    Carbon       light grey       Chlorine         green
  2479. PR    Oxygen       red              Bromine, Zinc    brown
  2480. PR    Hydogen      white            Sodium           blue
  2481. PR    Nitrogen     light blue       Iron             purple
  2482. PR    Sulphur      yellow           Calcium, Metals  dark grey
  2483. PR    Phosphorous  orange           Unknown          deep pink
  2484. AB
  2485.  
  2486. PR?group
  2487. PR?color group
  2488. PR?colour group
  2489. ASGroup Colours
  2490. ATThe RasMol
  2491. ACgroup
  2492. ATcolour scheme colour codes residues by their position in a macromolecular
  2493. ATchain. Each chain is drawn as a smooth spectrum from blue through green,
  2494. ATyellow and orange to red. Hence the N terminus of proteins and 5' terminus 
  2495. ATof nucleic acids are coloured red and the C terminus of proteins and 3' 
  2496. ATterminus of nucleic acids are drawn in blue. If a chain has a large number 
  2497. ATof heterogenous molecules associated with it, the macromolecule may not be
  2498. ATdrawn in the full `range' of the spectrum.
  2499. AB
  2500.  
  2501. PR?shapely
  2502. PR?shapely colors
  2503. PR?shapely colours
  2504. ASShapely Colours
  2505. ATThe RasMol
  2506. ACshapely
  2507. ATcolour scheme colour codes residues by amino acid property. This scheme
  2508. ATis based upon Bob Fletterick's "Shapely Models". Each amino acid and
  2509. ATnucleic acid residue is given a unique colour. The
  2510. ACshapely
  2511. ATcolour scheme is used by David Bacon's Raster3D program. This colour
  2512. ATscheme is similar to the
  2513. AXaminocolours amino
  2514. ATcolour scheme.
  2515. AB
  2516.  
  2517. PR?color structure
  2518. PR?colour structure
  2519. ASStructure Colours
  2520. ATThe RasMol
  2521. ACstructure
  2522. ATcolour scheme colours the molecule by protein secondary structure.
  2523. ATAlpha helices are coloured magenta,
  2524. PT[240,0,128],
  2525. ATbeta sheets are coloured yellow,
  2526. PT[255,255,0],
  2527. ATturns are coloured pale blue,
  2528. AT[96,128,255]
  2529. ATand all other residues are coloured white. The secondary structure
  2530. ATis either read from the PDB file (HELIX and SHEET records), if available,
  2531. ATor determined using Kabsch and Sander's DSSP algorithm. The RasMol
  2532. AXstructure structure
  2533. ATcommand may be used to force DSSP's structure assignment to be used.
  2534. AB
  2535.  
  2536. PR?temperature
  2537. PR?color temperature
  2538. PR?colour temperature
  2539. ASTemperature Colours
  2540. ATThe RasMol
  2541. ACtemperature
  2542. ATcolour scheme colour codes each atom according to the anisotropic
  2543. ATtemperature (beta) value stored in the PDB file. Typically this gives
  2544. ATa measure of the mobility/uncertainty of a given atom's position. High
  2545. ATvalues are coloured in warmer (red) colours and lower values in colder
  2546. AT(blue) colours. This feature is often used to associate a "scale" value
  2547. AT[such as amino acid variability in viral mutants] with each atom in a
  2548. ATPDB file, and colour the molecule appropriately.
  2549. AB
  2550.  
  2551. PR?user
  2552. PR?color user
  2553. PR?colour user
  2554. ASUser Colours
  2555. ATThe RasMol
  2556. ACuser
  2557. ATcolour scheme allows RasMol to use the colour scheme stored in the
  2558. ATPDB file. The colours for each atom are stored in COLO records placed
  2559. ATin the PDB data file. This convention was introducted by David Bacon's
  2560. ATRaster3D program.
  2561. AB
  2562.  
  2563. PR?type
  2564. PR?color type
  2565. PR?colour type
  2566. ASHBond Type Colours
  2567. ATThe RasMol
  2568. ACtype
  2569. ATcolour scheme applies only to hydrogen bonds, hence is used in the command
  2570. AC"colour hbonds type
  2571. ATThis colour scheme colour codes each hydrogen bond according to the 
  2572. ATdistance along a protein chain between hydrogen bond donor and acceptor.
  2573. ATThis schematic representation was introduced by Belhadj-Mostefa and
  2574. ATMilner-White. This representation gives a good insight into protein
  2575. ATsecondary structure (hbonds forming alpha helices appear red, those
  2576. ATforming sheets appear yellow and those forming turns appear magenta).
  2577. PP
  2578. PR      Offset    Colour    Triple
  2579. PR        +2      white     [255,255,255]
  2580. PR        +3      magenta   [255,0,255]
  2581. PR        +4      red       [255,0,0]
  2582. PR        +5      orange    [255,165,0]
  2583. PR        -3      cyan      [0,255,255]
  2584. PR        -4      green     [0,255,0]
  2585. PR      default   yellow    [255,255,0]
  2586. AP
  2587.  
  2588. %%
  2589. %% General Help
  2590. %%
  2591. PR?codes
  2592. PR?amino codes
  2593. PR?amino acid codes
  2594. PRAmino Acid Codes
  2595. PTThe following table lists the names, single letter and three letter
  2596. PTcodes of each of the amino acids.
  2597. PP
  2598.  
  2599. PR    Alanine         A  ALA         Arginine        R  ARG
  2600. PR    Asparagine      N  ASN         Aspartic acid   D  ASP
  2601. PR    Cysteine        C  CYS         Glutamic acid   E  GLU
  2602. PR    Glutamine       Q  GLN         Glycine         G  GLY
  2603. PR    Histidine       H  HIS         Isoleucine      I  ILE
  2604. PR    Leucine         L  LEU         Lysine          K  LYS
  2605. PR    Methionine      M  MET         Phenylalanine   F  PHE
  2606. PR    Proline         P  PRO         Serine          S  SER
  2607. PR    Threonine       T  THR         Tryptophan      W  TRP
  2608. PR    Tyrosine        Y  TYR         Valine          V  VAL
  2609. PB
  2610.  
  2611.  
  2612. PR?boolean
  2613. PR?booleans
  2614. PR?boolean expression
  2615. PR?boolean expressions
  2616. PRBooleans
  2617. PTA boolean parameter is a truth value. Valid boolean values are `true' and
  2618. PT`false', and their synonyms `on' and `off'. Boolean parameters are commonly
  2619. PTused by RasMol to either enable or disable a representation or option.
  2620. PP
  2621.  
  2622. %%
  2623. %% Signature
  2624. %%
  2625. %%
  2626. MT.SH SEE ALSO
  2627. MTThe RasMol User Manual!
  2628. MT
  2629. MT.SH AUTHOR
  2630. MTCopyright (C) 1992-94 by Roger Sayle. All rights reserved.
  2631. MT (rasmol@ggr.co.uk)
  2632.  
  2633. %%
  2634. %% RTF Closing
  2635. %%
  2636. RT}
  2637.